Ping.Send Метод

Определение

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на удаленный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to a remote computer and receive a corresponding ICMP echo reply message from the remote computer.

Перегрузки

Send(String, Int32, Byte[], PingOptions)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.

Send(IPAddress, Int32, Byte[], PingOptions)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet.

Send(String, Int32, Byte[])

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции.This overload allows you to specify a time-out value for the operation.

Send(IPAddress, Int32, Byte[])

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции.This overload allows you to specify a time-out value for the operation.

Send(String, Int32)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Этот метод позволяет указать тайм-аут операции.This method allows you to specify a time-out value for the operation.

Send(IPAddress, Int32)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Этот метод позволяет указать тайм-аут операции.This method allows you to specify a time-out value for the operation.

Send(String)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.

Send(IPAddress)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer.

Комментарии

IP-адрес, возвращенный любой из Send перегрузок, может исходить от вредоносного удаленного компьютера.The IP address returned by any of the Send overloads can originate from a malicious remote computer. Не подключайтесь к удаленному компьютеру с помощью этого компонента.Do not connect to the remote computer using this. Используйте DNS для определения IP-адреса компьютера, к которому необходимо подключиться.Use DNS to determine the IP address of the machine to which you want to connect.

Send(String, Int32, Byte[], PingOptions)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);
member this.Send : string * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

Параметры

hostNameOrAddress
String

Объект String, идентифицирующий компьютер, на который будет отправлено данное сообщение проверки связи ICMP.A String that identifies the computer that is the destination for the ICMP echo message. Заданное для этого параметра значение может быть именем узла или строковым представлением IP-адреса.The value specified for this parameter can be a host name or a string representation of an IP address.

timeout
Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Массив Byte, содержащие данные, отправляемые с сообщением проверки связи ICMP и возвращаемые с сообщением ответа проверки связи ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. Массив не может содержать более 65 500 байт.The array cannot contain more than 65,500 bytes.

options
PingOptions

Объект PingOptions, используемый для управления значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.A PingOptions object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Исключения

Размер буфера, указанного в параметре buffer, превышает 65500 байт.The size of buffer exceeds 65500 bytes.

hostNameOrAddress имеет значение null или является пустой строкой.hostNameOrAddress is null or is a zero-length string.

- или --or- Параметр buffer имеет значение null или размер буфера, указанного в параметре buffer, превышает 65 500 байт.buffer is null, or the buffer size is greater than 65500 bytes.

Значение параметра timeout меньше нуля.timeout is less than zero.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Параметр address является IPv6-адресом, а на локальном компьютере установлена операционная система более ранней версии, чем Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

В следующем примере кода показано, как вызвать этот метод.The following code example demonstrates how to call this method.

void ComplexPing()
{
   Ping ^ pingSender = gcnew Ping;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   
   // Send the request.
   PingReply ^ reply = pingSender->Send( "www.contoso.com", timeout, buffer, options );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void ComplexPing ()
{
    Ping pingSender = new Ping ();

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);

    // Send the request.
    PingReply reply = pingSender.Send ("www.contoso.com", timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Комментарии

Если сообщение ICMP эхо-ответа не получено в течение времени, указанного параметром timeout, эхо ICMP не выполняется, а свойство Status имеет значение TimedOut.If the ICMP echo reply message is not received within the time specified by the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Примечание

При указании очень маленьких чисел для timeoutответ на запрос проверки связи можно получить, даже если истечет timeout миллисекунд.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Если свойство DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, то запрос проверки связи ICMP завершается сбоем.If the DontFragment property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig.

Используйте свойство Ttl, чтобы указать максимальное число попыток переадресации сообщения проверки связи ICMP перед достижением места назначения.Use the Ttl property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(IPAddress, Int32, Byte[], PingOptions)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);
member this.Send : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

Параметры

address
IPAddress

Объект IPAddress, идентифицирующий компьютер, на который будет направлено данное сообщение проверки связи ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

timeout
Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Массив Byte, содержащие данные, отправляемые с сообщением проверки связи ICMP и возвращаемые с сообщением ответа проверки связи ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. Массив не может содержать более 65 500 байт.The array cannot contain more than 65,500 bytes.

options
PingOptions

Объект PingOptions, используемый для управления значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.A PingOptions object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. Метод возвращает PacketTooBig, если пакет превышает MTU.The method will return PacketTooBig if the packet exceeds the Maximum Transmission Unit (MTU).

Исключения

Размер буфера, указанного в параметре buffer, превышает 65500 байт.The size of buffer exceeds 65500 bytes.

Свойство address имеет значение null.address is null.

- или --or- Параметр buffer имеет значение null или размер буфера, указанного в параметре buffer, превышает 65 500 байт.buffer is null, or the buffer size is greater than 65500 bytes.

Значение параметра timeout меньше нуля.timeout is less than zero.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Параметр address является IPv6-адресом, а на локальном компьютере установлена операционная система более ранней версии, чем Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

В следующем примере кода показано, как вызвать этот метод.The following code example demonstrates how to call this method.

void ComplexLocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   PingReply ^ reply = pingSender->Send( address, timeout, buffer, options );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void ComplexLocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);
    PingReply reply = pingSender.Send (address, timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Комментарии

Если сообщение ICMP эхо-ответа не получено в течение времени, указанного параметром timeout, эхо ICMP не выполняется, а свойство Status имеет значение TimedOut.If the ICMP echo reply message is not received within the time specified by the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Примечание

При указании очень маленьких чисел для timeoutответ на запрос проверки связи можно получить, даже если истечет timeout миллисекунд.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Если свойство DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, то запрос проверки связи ICMP завершается сбоем.If the DontFragment property is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig.

Используйте свойство Ttl, чтобы указать максимальное число попыток переадресации сообщения проверки связи ICMP перед достижением места назначения.Use the Ttl property to specify the maximum number of times the ICMP echo message can be forwarded before reaching its destination. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(String, Int32, Byte[])

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции.This overload allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer);
member this.Send : string * int * byte[] -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte()) As PingReply

Параметры

hostNameOrAddress
String

Объект String, идентифицирующий компьютер, на который будет отправлено данное сообщение проверки связи ICMP.A String that identifies the computer that is the destination for the ICMP echo message. Заданное для этого параметра значение может быть именем узла или строковым представлением IP-адреса.The value specified for this parameter can be a host name or a string representation of an IP address.

timeout
Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Массив Byte, содержащие данные, отправляемые с сообщением проверки связи ICMP и возвращаемые с сообщением ответа проверки связи ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. Массив не может содержать более 65 500 байт.The array cannot contain more than 65,500 bytes.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Исключения

Размер буфера, указанного в параметре buffer, превышает 65500 байт.The size of buffer exceeds 65500 bytes.

Параметр hostNameOrAddress равен null или является пустой строкой ("").hostNameOrAddress is null or is an empty string ("").

- или --or- Параметр buffer имеет значение null или размер буфера, указанного в параметре buffer, превышает 65 500 байт.buffer is null, or the buffer size is greater than 65500 bytes.

Значение параметра timeout меньше нуля.timeout is less than zero.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

Пример, демонстрирующий вызов перегрузки Send, см. в разделе Общие сведения о классе Ping.For an example that demonstrates how to call a Send overload, see the Ping class overview.

Комментарии

Если сообщение ICMP эхо-ответа не получено в течение времени, указанного параметром timeout, то эхо ICMP не выполняется, а свойство Status имеет значение TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Примечание

При указании очень маленьких чисел для timeoutответ на запрос проверки связи можно получить, даже если истечет timeout миллисекунд.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Эта перегрузка использует параметры по умолчанию для фрагментации пакетов и пересылки пакетов.This overload uses default settings for packet fragmentation and packet forwarding. Пакет, содержащий Эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Чтобы предотвратить фрагментацию, используйте один из Send методов, принимающих параметр options, и задайте для свойства DontFragment значение true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Если DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос проверки связи ICMP завершается сбоем.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig.

Пакеты или фрагменты пакетов могут перенаправляться узлами маршрутизации 128 раз, прежде чем они будут удалены.The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. Чтобы изменить этот параметр, используйте перегрузку Send, которая принимает параметр options, и присвойте свойству Ttl нужное значение.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(IPAddress, Int32, Byte[])

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Эта перегруженная версия метода позволяет указать тайм-аут операции.This overload allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer);
member this.Send : System.Net.IPAddress * int * byte[] -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte()) As PingReply

Параметры

address
IPAddress

Объект IPAddress, идентифицирующий компьютер, на который будет направлено данное сообщение проверки связи ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

timeout
Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

buffer
Byte[]

Массив Byte, содержащие данные, отправляемые с сообщением проверки связи ICMP и возвращаемые с сообщением ответа проверки связи ICMP.A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. Массив не может содержать более 65 500 байт.The array cannot contain more than 65,500 bytes.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. Метод возвращает PacketTooBig, если пакет превышает MTU.The method will return PacketTooBig if the packet exceeds the Maximum Transmission Unit (MTU).

Исключения

Размер буфера, указанного в параметре buffer, превышает 65500 байт.The size of buffer exceeds 65500 bytes.

addressnull.address is null.

- или --or- Параметр buffer имеет значение null или размер буфера, указанного в параметре buffer, превышает 65 500 байт.buffer is null, or the buffer size is greater than 65500 bytes.

Значение параметра timeout меньше нуля.timeout is less than zero.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Параметр address является IPv6-адресом, а на локальном компьютере установлена операционная система более ранней версии, чем Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

В следующем примере кода показано, как вызвать этот метод.The following code example demonstrates how to call this method.

void LocalPingTimeout()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   PingReply ^ reply = pingSender->Send( address, timeout, buffer);
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void LocalPingTimeout ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;
    PingReply reply = pingSender.Send (address, timeout, buffer);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Комментарии

Если сообщение ICMP эхо-ответа не получено в течение времени, указанного параметром timeout, то эхо ICMP не выполняется, а свойство Status имеет значение TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Примечание

При указании очень маленьких чисел для timeoutответ на запрос проверки связи можно получить, даже если истечет timeout миллисекунд.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Эта перегрузка использует параметры по умолчанию для фрагментации пакетов и пересылки пакетов.This overload uses default settings for packet fragmentation and packet forwarding. Пакет, содержащий Эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Чтобы предотвратить фрагментацию, используйте один из Send методов, принимающих параметр options, и задайте для свойства DontFragment значение true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Если DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос проверки связи ICMP завершается сбоем.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig.

Пакеты или фрагменты пакетов могут перенаправляться узлами маршрутизации 128 раз, прежде чем они будут удалены.The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. Чтобы изменить этот параметр, используйте перегрузку Send, которая принимает параметр options, и присвойте свойству Ttl нужное значение.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(String, Int32)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. Этот метод позволяет указать тайм-аут операции.This method allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout);
member this.Send : string * int -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String, timeout As Integer) As PingReply

Параметры

hostNameOrAddress
String

Объект String, идентифицирующий компьютер, на который будет отправлено данное сообщение проверки связи ICMP.A String that identifies the computer that is the destination for the ICMP echo message. Заданное для этого параметра значение может быть именем узла или строковым представлением IP-адреса.The value specified for this parameter can be a host name or a string representation of an IP address.

timeout
Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Исключения

Параметр hostNameOrAddress равен null или является пустой строкой ("").hostNameOrAddress is null or is an empty string ("").

Значение параметра timeout меньше нуля.timeout is less than zero.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

Пример, демонстрирующий вызов метода Send, см. в разделе Общие сведения о классе Ping.For an example that demonstrates calling a Send method, see the Ping class overview.

Комментарии

Если сообщение ICMP эхо-ответа не получено в течение времени, указанного параметром timeout, то эхо ICMP не выполняется, а свойство Status имеет значение TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Примечание

При указании очень маленьких чисел для timeoutответ на запрос проверки связи можно получить, даже если истечет timeout миллисекунд.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Эта перегрузка использует параметры по умолчанию для фрагментации пакетов и пересылки пакетов.This overload uses default settings for packet fragmentation and packet forwarding. Пакет, содержащий Эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Чтобы предотвратить фрагментацию, используйте один из Send методов, принимающих параметр options, и задайте для свойства DontFragment значение true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Если DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос проверки связи ICMP завершается сбоем.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig. Фрагменты пакетов или пакетов (если они фрагментированы) могут перенаправляться узлами маршрутизации 128 раз, прежде чем они будут удалены.The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. Чтобы изменить этот параметр, используйте перегрузку Send, которая принимает параметр options, и присвойте свойству Ttl нужное значение.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(IPAddress, Int32)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer. Этот метод позволяет указать тайм-аут операции.This method allows you to specify a time-out value for the operation.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout);
member this.Send : System.Net.IPAddress * int -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress, timeout As Integer) As PingReply

Параметры

address
IPAddress

Объект IPAddress, идентифицирующий компьютер, на который будет направлено данное сообщение проверки связи ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

timeout
Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.An Int32 value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.

Исключения

Свойство address имеет значение null.address is null.

Значение параметра timeout меньше нуля.timeout is less than zero.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Параметр address является IPv6-адресом, а на локальном компьютере установлена операционная система более ранней версии, чем Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

Пример, демонстрирующий вызов метода Send, см. в разделе Общие сведения о классе Ping.For an example that demonstrates calling a Send method, see the Ping class overview.

Комментарии

Если сообщение ICMP эхо-ответа не получено в течение времени, указанного параметром timeout, то эхо ICMP не выполняется, а свойство Status имеет значение TimedOut.If the ICMP echo reply message is not received within the time specified in the timeout parameter, the ICMP echo fails, and the Status property is set to TimedOut.

Примечание

При указании очень маленьких чисел для timeoutответ на запрос проверки связи можно получить, даже если истечет timeout миллисекунд.When specifying very small numbers for timeout, the Ping reply can be received even if timeout milliseconds have elapsed.

Эта перегрузка использует параметры по умолчанию для фрагментации пакетов и пересылки пакетов.This overload uses default settings for packet fragmentation and packet forwarding. Пакет, содержащий Эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Чтобы предотвратить фрагментацию, используйте один из Send методов, принимающих параметр options, и задайте для свойства DontFragment значение true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Если DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос проверки связи ICMP завершается сбоем.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig.

Пакеты или фрагменты пакетов могут перенаправляться узлами маршрутизации 128 раз, прежде чем они будут удалены.The packet or packet fragments can be forwarded by routing nodes 128 times before being discarded. Чтобы изменить этот параметр, используйте перегрузку Send, которая принимает параметр options, и присвойте свойству Ttl нужное значение.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(String)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress);
public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress);
member this.Send : string -> System.Net.NetworkInformation.PingReply
Public Function Send (hostNameOrAddress As String) As PingReply

Параметры

hostNameOrAddress
String

Объект String, идентифицирующий компьютер, на который будет отправлено данное сообщение проверки связи ICMP.A String that identifies the computer that is the destination for the ICMP echo message. Заданное для этого параметра значение может быть именем узла или строковым представлением IP-адреса.The value specified for this parameter can be a host name or a string representation of an IP address.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received.

Исключения

Параметр hostNameOrAddress равен null или является пустой строкой ("").hostNameOrAddress is null or is an empty string ("").

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Параметр address является IPv6-адресом, а на локальном компьютере установлена операционная система более ранней версии, чем Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

В следующем примере кода демонстрируется вызов этого метода.The following code example demonstrates calling this method.

void SimplePing()
{
   Ping ^ pingSender = gcnew Ping;
   PingReply ^ reply = pingSender->Send( "www.contoso.com" );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void SimplePing ()
{
    Ping pingSender = new Ping ();
    PingReply reply = pingSender.Send ("www.contoso.com");

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Комментарии

Этот метод отправляет буфер данных 32 Byte с сообщением проверки связи ICMP.This method sends a 32 Byte data buffer with the ICMP echo message. Метод ожидает пять секунд для сообщения ответа проверки связи ICMP.The method waits five seconds for an ICMP echo reply message. Если он не получает ответ в это время, метод возвращает значение, а свойство StatusTimedOut.If it does not receive a reply in that time, the method returns and the Status property is set to TimedOut.

Эта перегрузка использует параметры по умолчанию для фрагментации пакетов и пересылки пакетов.This overload uses default settings for packet fragmentation and packet forwarding. Пакет, содержащий Эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Чтобы предотвратить фрагментацию, используйте один из Send методов, принимающих параметр options, и задайте для свойства DontFragment значение true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Если DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос проверки связи ICMP завершается сбоем.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig. Фрагменты пакетов или пакетов (если они фрагментированы) могут перенаправляться узлами маршрутизации 128 раз, прежде чем они будут удалены.The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. Чтобы изменить этот параметр, используйте перегрузку Send, которая принимает параметр options, и присвойте свойству Ttl нужное значение.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Send(IPAddress)

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified IPAddress, and receive a corresponding ICMP echo reply message from that computer.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address);
public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address);
member this.Send : System.Net.IPAddress -> System.Net.NetworkInformation.PingReply
Public Function Send (address As IPAddress) As PingReply

Параметры

address
IPAddress

Объект IPAddress, идентифицирующий компьютер, на который будет направлено данное сообщение проверки связи ICMP.An IPAddress that identifies the computer that is the destination for the ICMP echo message.

Возвраты

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или описание причины сбоя, если сообщение не было получено.A PingReply object that provides information about the ICMP echo reply message, if one was received, or describes the reason for the failure if no message was received.

Исключения

Свойство address имеет значение null.address is null.

Выполняется вызов SendAsync.A call to SendAsync is in progress.

Параметр address является IPv6-адресом, а на локальном компьютере установлена операционная система более ранней версии, чем Windows 2000.address is an IPv6 address and the local computer is running an operating system earlier than Windows 2000.

Возникло исключение при отправке или получении сообщений ICMP.An exception was thrown while sending or receiving the ICMP messages. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.See the inner exception for the exact exception that was thrown.

Данный объект удален.This object has been disposed.

Примеры

В следующем примере кода демонстрируется вызов этого метода.The following code example demonstrates calling this method.

void LocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   PingReply ^ reply = pingSender->Send( address );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}


public static void LocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;
    PingReply reply = pingSender.Send (address);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

Комментарии

Этот метод отправляет на узел, указанный в address буфер данных 32 Byte с сообщением проверки связи ICMP.This method sends to the host that is specified by address a 32 Byte data buffer with the ICMP echo message. Метод ожидает пять секунд для сообщения ответа проверки связи ICMP.The method waits five seconds for an ICMP echo reply message. Если он не получает ответ в это время, метод возвращает значение, а свойство StatusTimedOut.If it does not receive a reply in that time, the method returns and the Status property is set to TimedOut.

Эта перегрузка использует параметры по умолчанию для фрагментации пакетов и пересылки пакетов.This overload uses default settings for packet fragmentation and packet forwarding. Пакет, содержащий Эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами.The packet that contains the ICMP echo message can be fragmented in transit if the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers. Чтобы предотвратить фрагментацию, используйте один из Send методов, принимающих параметр options, и задайте для свойства DontFragment значение true.To prevent fragmentation, use one of the Send methods that takes an options parameter, and set the DontFragment property to true. Если DontFragment true, а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос проверки связи ICMP завершается сбоем.When DontFragment is true and the total packet size exceeds the maximum packet size that can be transmitted by one of the routing nodes between the local and remote computers, the ICMP echo request fails. В этом случае для Status устанавливается значение PacketTooBig.When this happens, the Status is set to PacketTooBig. Фрагменты пакетов или пакетов (если они фрагментированы) могут перенаправляться узлами маршрутизации 128 раз, прежде чем они будут удалены.The packet or packet fragments (if fragmented) can be forwarded by routing nodes 128 times before being discarded. Чтобы изменить этот параметр, используйте перегрузку Send, которая принимает параметр options, и присвойте свойству Ttl нужное значение.To change this setting, use a Send overload that takes an options parameter, and set the Ttl property to the desired value. Если пакет не достигает места назначения после пересылки указанного числа раз, пакет отбрасывается и запрос проверки связи ICMP завершается сбоем.If the packet does not reach its destination after being forwarded the specified number of times, the packet is discarded and the ICMP echo request fails. В этом случае для Status устанавливается значение TtlExpired.When this happens, the Status is set to TtlExpired.

Безопасность

NetworkInformationPermission
Для отправки сообщения проверки связи ICMP.To send an ICMP echo message. Связанное перечисление: PingAssociated enumeration: Ping

Применяется к