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

Ping.SendPingAsync Метод

  • Ссылка

Определение

Пространство имен:
System.Net.NetworkInformation
Сборка:
System.Net.Ping.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Отправляет сообщение запроса проверки связи ICMP на компьютер и получает от него соответствующее сообщения ответа проверки связи ICMP как асинхронная операция.

Перегрузки

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)

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

Отправляет сообщение запроса проверки связи ICMP с заданным буфером данных на компьютер с указанным IPAddress и получает от него соответствующее сообщения ответа проверки связи ICMP как асинхронная операция.
SendPingAsync(String)

Отправляет сообщение запроса проверки связи ICMP с заданным буфером данных на указанный компьютер и получает от него соответствующее сообщения ответа проверки связи ICMP как асинхронная операция.
SendPingAsync(IPAddress, Int32)

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

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

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

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

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

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

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

Комментарии

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

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)

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

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

public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, TimeSpan timeout, byte[]? buffer = default, System.Net.NetworkInformation.PingOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
member this.SendPingAsync : string * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>
Public Function SendPingAsync (hostNameOrAddress As String, timeout As TimeSpan, Optional buffer As Byte() = Nothing, Optional options As PingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PingReply)

Параметры

hostNameOrAddress
String

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

timeout
TimeSpan

Время (после отправки эхо-сообщения) на ожидание сообщения ответа на эхо ICMP.

buffer
Byte[]

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

options
PingOptions

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

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

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

Task<PingReply>

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

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

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

SendPingAsync(IPAddress)

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

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

public:
 System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address);
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address);
member this.SendPingAsync : System.Net.IPAddress -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>
Public Function SendPingAsync (address As IPAddress) As Task(Of PingReply)

Параметры

address
IPAddress

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

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

PingException

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

SocketException

address не является допустимым IP-адресом.

ObjectDisposedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

SendPingAsync(String)

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

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

public:
 System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress);
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress);
member this.SendPingAsync : string -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>
Public Function SendPingAsync (hostNameOrAddress As String) As Task(Of PingReply)

Параметры

hostNameOrAddress
String

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

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

InvalidOperationException

Выполняется вызов метода SendAsync(String, Object).

PingException

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

SocketException

Параметр hostNameOrAddress не удалось разрешить в допустимый IP-адрес.

ObjectDisposedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

SendPingAsync(IPAddress, Int32)

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

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

public:
 System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout);
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout);
member this.SendPingAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>
Public Function SendPingAsync (address As IPAddress, timeout As Integer) As Task(Of PingReply)

Параметры

address
IPAddress

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

timeout
Int32

Максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

PingException

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

SocketException

address не является допустимым IP-адресом.

ObjectDisposedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

SendPingAsync(String, Int32)

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

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

public:
 System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout);
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout);
member this.SendPingAsync : string * int -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>
Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer) As Task(Of PingReply)

Параметры

hostNameOrAddress
String

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

timeout
Int32

Максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

InvalidOperationException

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

PingException

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

SocketException

address не является допустимым IP-адресом.

ObjectDisposedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

SendPingAsync(IPAddress, Int32, Byte[])

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

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

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

Параметры

address
IPAddress

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

timeout
Int32

Максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

buffer
Byte[]

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

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

InvalidOperationException

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

PingException

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

SocketException

address не является допустимым IP-адресом.

ObjectDisposedException

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

ArgumentException

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

PlatformNotSupportedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

SendPingAsync(String, Int32, Byte[])

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

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

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

Параметры

hostNameOrAddress
String

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

timeout
Int32

Максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

buffer
Byte[]

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

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

-или-

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

ArgumentOutOfRangeException

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

InvalidOperationException

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

PingException

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

SocketException

Параметр hostNameOrAddress не удалось разрешить в допустимый IP-адрес.

ObjectDisposedException

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

ArgumentException

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

PlatformNotSupportedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

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

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

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

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

Параметры

address
IPAddress

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

timeout
Int32

Максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

buffer
Byte[]

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

options
PingOptions

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

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

InvalidOperationException

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

PingException

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

SocketException

address не является допустимым IP-адресом.

ObjectDisposedException

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

ArgumentException

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

PlatformNotSupportedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

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

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

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

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

Параметры

hostNameOrAddress
String

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

timeout
Int32

Максимальное время (после отправки сообщения проверки связи) ожидания сообщения ответа проверки связи ICMP в миллисекундах.

buffer
Byte[]

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

options
PingOptions

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

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

Task<PingReply>

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

Исключения

ArgumentNullException

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

-или-

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

ArgumentOutOfRangeException

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

InvalidOperationException

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

PingException

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

SocketException

Параметр hostNameOrAddress не удалось разрешить в допустимый IP-адрес.

ObjectDisposedException

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

ArgumentException

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

PlatformNotSupportedException

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult>> объект завершится после отправки пакета ICMP и получения ответа.

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

SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)

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

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

public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, TimeSpan timeout, byte[]? buffer = default, System.Net.NetworkInformation.PingOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
member this.SendPingAsync : System.Net.IPAddress * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>
Public Function SendPingAsync (address As IPAddress, timeout As TimeSpan, Optional buffer As Byte() = Nothing, Optional options As PingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PingReply)

Параметры

address
IPAddress

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

timeout
TimeSpan

Время (после отправки эхо-сообщения) на ожидание сообщения ответа на эхо ICMP.

buffer
Byte[]

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

options
PingOptions

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

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены. Значение по умолчанию — None.

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

Task<PingReply>

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

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

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