Ping.Send Метод

Ссылка

Определение

Пространство имен:: System.Net.NetworkInformation

Сборка:: System.Net.Ping.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на удаленный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.

Перегрузки

Send(String, TimeSpan, Byte[], PingOptions)	Пытается отправить эхо-сообщение ICMP на указанный компьютер и получить соответствующее сообщение ответа icMP эха с этого компьютера.
Send(String, Int32, Byte[], PingOptions)	Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета ICMP.
Send(IPAddress, TimeSpan, Byte[], PingOptions)	Пытается отправить эхо-сообщение ICMP на компьютер с указанным IPAddressпараметром и получить соответствующее сообщение ответа ICMP с этого компьютера.
Send(IPAddress, Int32, Byte[], PingOptions)	Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.
Send(String, Int32, Byte[])	Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP. Эта перегруженная версия метода позволяет указать тайм-аут операции.
Send(IPAddress, Int32, Byte[])	Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP. Эта перегруженная версия метода позволяет указать тайм-аут операции.
Send(String, Int32)	Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP. Этот метод позволяет указать тайм-аут операции.
Send(IPAddress, Int32)	Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP. Этот метод позволяет указать тайм-аут операции.
Send(String)	Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.
Send(IPAddress)	Предпринимает попытку отправки сообщения запроса проверки связи ICMP на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.

IP-адрес, возвращаемый любой Send из перегрузок, может исходить от вредоносного удаленного компьютера. Не подключайтесь к удаленному компьютеру с помощью этого параметра. Используйте DNS, чтобы определить IP-адрес компьютера, к которому требуется подключиться.

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

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Пытается отправить эхо-сообщение ICMP на указанный компьютер и получить соответствующее сообщение ответа icMP эха с этого компьютера.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, TimeSpan timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, TimeSpan timeout, byte[]? buffer, System.Net.NetworkInformation.PingOptions? options);

member this.Send : string * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As TimeSpan, buffer As Byte(), options As PingOptions) As PingReply

Параметры

hostNameOrAddress: String

Объект String, идентифицирующий компьютер, на который будет отправлено данное сообщение проверки связи ICMP. Заданное для этого параметра значение может быть именем узла или строковым представлением IP-адреса.

timeout: TimeSpan

Значение типа , указывающее максимальное время (после отправки эхо-сообщения) для ожидания ответа на эхо-сообщение ICMP.

buffer: Byte[]

Массив Byte, содержащие данные, отправляемые с сообщением проверки связи ICMP и возвращаемые с сообщением ответа проверки связи ICMP. Массив не может содержать более 65 500 байт.

options: PingOptions

Объект PingOptions, используемый для управления значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.

Возвращаемое значение

PingReply

Сведения о сообщении ответа ICMP, если оно было получено, или причина сбоя, если сообщение не было получено.

Исключения

ArgumentNullException

buffer или hostNameOrAddress имеет null значение или hostNameOrAddress является пустой строкой ("").

ArgumentOutOfRangeException

timeout представляет время меньше нуля миллисекунда или больше MaxValue миллисекунда.

ArgumentException

Размер bufferфайла превышает 65 500 байт.

InvalidOperationException

Выполняется вызов SendAsync.

PingException

Возникло исключение при отправке или получении сообщений ICMP. Чтобы узнать, какое именно исключение возникло, обратитесь ко внутреннему исключению.

ObjectDisposedException

Данный объект удален.

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

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

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета ICMP.

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);

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

timeout: Int32

Значение Int32, указывающее максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

buffer: Byte[]

options: PingOptions

Возвращаемое значение

PingReply

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено.

Исключения

ArgumentException

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

ArgumentNullException

hostNameOrAddress имеет значение null или является пустой строкой.

-или-

buffer имеет значение null.

ArgumentOutOfRangeException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

PlatformNotSupportedException

.NET 7 и более поздних версий только в Linux: процесс не является привилегированным и buffer не является пустым.

Примеры

В следующем примере кода показано, как вызвать этот метод.

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.

Примечание

При указании очень небольших чисел для timeoutответа Ping можно получить, даже если timeout прошло миллисекунда.

DontFragment Если свойство имеет значение , true а общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, эхо-запрос ICMP завершается ошибкой. В этом случае параметру Status присваивается значение PacketTooBig.

Используйте свойство , Ttl чтобы указать максимальное число переадресовок эхо-сообщения ICMP до достижения места назначения. Если пакет не достигает места назначения после перенаправления указанного числа раз, пакет отклоняется, а эхо-запрос ICMP завершается ошибкой. В этом случае параметру Status присваивается значение TtlExpired.

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

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

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Пытается отправить эхо-сообщение ICMP на компьютер с указанным IPAddressпараметром и получить соответствующее сообщение ответа ICMP с этого компьютера.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, TimeSpan timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, TimeSpan timeout, byte[]? buffer, System.Net.NetworkInformation.PingOptions? options);

member this.Send : System.Net.IPAddress * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As TimeSpan, buffer As Byte(), options As PingOptions) As PingReply

Параметры

address: IPAddress

Объект IPAddress, идентифицирующий компьютер, на который будет направлено данное сообщение проверки связи ICMP.

timeout: TimeSpan

buffer: Byte[]

options: PingOptions

Возвращаемое значение

PingReply

Сведения о сообщении ответа ICMP, если оно было получено, или причина сбоя, если сообщение не было получено.

Исключения

ArgumentNullException

Параметр address или buffer имеет значение null.

ArgumentOutOfRangeException

timeout представляет время меньше нуля миллисекунда или больше MaxValue миллисекунда.

ArgumentException

Размер bufferфайла превышает 65 500 байт.

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

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

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

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP. Эта перегруженная версия метода позволяет указать тайм-аут операции и управлять значениями фрагментации и срока жизни пакета сообщения проверки связи ICMP.

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);

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.

timeout: Int32

buffer: Byte[]

options: PingOptions

Возвращаемое значение

PingReply

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или причину сбоя, если сообщение не было получено. Метод возвращает PacketTooBig, если пакет превышает MTU.

Исключения

ArgumentException

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

ArgumentNullException

Параметр address или buffer имеет значение null.

ArgumentOutOfRangeException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

PlatformNotSupportedException

.NET 7 и более поздних версий только в Linux: процесс не является привилегированным и buffer не является пустым.

Примеры

В следующем примере кода показано, как вызвать этот метод.

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.

Примечание

При указании очень небольших чисел для timeoutответа Ping можно получить, даже если timeout прошло миллисекунда.

DontFragment Если свойство имеет значение true и общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос на эхо ICMP завершается ошибкой. В этом случае параметру Status присваивается значение PacketTooBig.

Используйте свойство , Ttl чтобы указать максимальное количество переадресации эхо-сообщения ICMP до достижения места назначения. Если пакет не достигает места назначения после перенаправления указанного числа раз, пакет удаляется и запрос на эхо ICMP завершается сбоем. В этом случае параметру Status присваивается значение TtlExpired.

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

Send(String, Int32, Byte[])

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

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

timeout: Int32

buffer: Byte[]

Возвращаемое значение

PingReply

Исключения

ArgumentException

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

ArgumentNullException

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

-или-

buffer имеет значение null.

ArgumentOutOfRangeException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

PlatformNotSupportedException

.NET 7 и более поздних версий только в Linux: процесс не является привилегированным и buffer не является пустым.

Примеры

Пример, демонстрирующий вызов Send перегрузки, см. в обзоре Ping класса.

Пакет или фрагменты пакетов можно перенаправить, перенаправив узлы 128 раз, прежде чем они будут удалены. Чтобы изменить этот параметр, используйте перегрузку Sendoptions , которая принимает параметр, и присвойте Ttl свойству нужное значение. Если пакет не достигает места назначения после перенаправления указанного числа раз, пакет удаляется и запрос на эхо ICMP завершается сбоем. В этом случае параметру Status присваивается значение TtlExpired.

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

Send(IPAddress, Int32, Byte[])

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

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.

timeout: Int32

buffer: Byte[]

Возвращаемое значение

PingReply

Исключения

ArgumentException

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

ArgumentNullException

Параметр address или buffer имеет значение null.

ArgumentOutOfRangeException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

PlatformNotSupportedException

.NET 7 и более поздних версий только в Linux: процесс не является привилегированным и buffer не является пустым.

Примеры

В следующем примере кода показано, как вызвать этот метод.

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);
    }
}

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

Send(String, Int32)

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP. Этот метод позволяет указать тайм-аут операции.

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

timeout: Int32

Возвращаемое значение

PingReply

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

Примеры

Пример, демонстрирующий Send вызов метода, см. в обзоре Ping класса.

Эта перегрузка использует параметры по умолчанию для фрагментации и пересылки пакетов. Пакет, содержащий эхо-сообщение ICMP, может быть фрагментирован при передаче, если общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами. Чтобы предотвратить фрагментацию, используйте один из Send методов, который принимает options параметр , и задайте для свойства значение DontFragmenttrue. Если DontFragment имеет значение true и общий размер пакета превышает максимальный размер пакета, который может быть передан одним из узлов маршрутизации между локальным и удаленным компьютерами, запрос на эхо ICMP завершается ошибкой. В этом случае параметру Status присваивается значение PacketTooBig. Пакеты или фрагменты пакетов (если они фрагментированы) можно перенаправить путем маршрутизации узлов 128 раз, прежде чем они будут удалены. Чтобы изменить этот параметр, используйте перегрузку Sendoptions , которая принимает параметр, и присвойте Ttl свойству нужное значение. Если пакет не достигает места назначения после перенаправления указанного числа раз, пакет удаляется и запрос на эхо ICMP завершается сбоем. В этом случае параметру Status присваивается значение TtlExpired.

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

Send(IPAddress, Int32)

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Предпринимает попытку отправки сообщения запроса проверки связи ICMP с заданным буфером данных на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP. Этот метод позволяет указать тайм-аут операции.

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.

timeout: Int32

Возвращаемое значение

PingReply

Исключения

ArgumentNullException

address имеет значение null.

ArgumentOutOfRangeException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

Примеры

Пример, демонстрирующий Send вызов метода, см. в обзоре Ping класса.

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

Send(String)

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на указанный компьютер и получения от него соответствующего сообщения ответа проверки связи ICMP.

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

Возвращаемое значение

PingReply

Исключения

ArgumentNullException

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

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

Примеры

В следующем примере кода демонстрируется вызов этого метода.

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. Метод ожидает 5 секунд ответа на эхо-сообщение ICMP. Если он не получает ответ в течение этого времени, метод возвращает значение , а свойству Status присваивается значение TimedOut.

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

Send(IPAddress)

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Исходный код:: Ping.cs

Предпринимает попытку отправки сообщения запроса проверки связи ICMP на удаленный компьютер с указанным IPAddress и получения от него соответствующего сообщения ответа проверки связи ICMP.

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.

Возвращаемое значение

PingReply

Объект PingReply, предоставляющий сведения о сообщении ответа проверки связи ICMP, если оно было получено, или описание причины сбоя, если сообщение не было получено.

Исключения

ArgumentNullException

address имеет значение null.

InvalidOperationException

Выполняется вызов SendAsync.

PingException

ObjectDisposedException

Данный объект удален.

Примеры

В следующем примере кода демонстрируется вызов этого метода.

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. Метод ожидает 5 секунд ответа на эхо-сообщение ICMP. Если он не получает ответ в течение этого времени, метод возвращает значение , а свойству Status присваивается значение TimedOut.

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

Поделиться через

Ping.Send Метод

Определение

Перегрузки

Комментарии

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

Параметры

Возвращаемое значение

Исключения

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

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

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

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

Параметры

Возвращаемое значение

Исключения

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

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

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Send(String, Int32, Byte[])

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Send(IPAddress, Int32, Byte[])

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Send(String, Int32)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Send(IPAddress, Int32)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Send(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Send(IPAddress)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы