Ping.SendPingAsync 方法

定义

命名空间:: System.Net.NetworkInformation

程序集:: netstandard.dll, System.Net.Ping.dll

程序集:: System.Net.Ping.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将 Internet 控制消息协议（ICMP）回显消息发送到计算机，并将该计算机的相应 ICMP 回显回复消息作为异步操作接收。

重载

名称	说明
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到指定计算机，并将相应 ICMP 回显答复消息作为异步操作从该计算机接收。此重载允许指定操作的超时值、用于发送和接收的缓冲区、控制碎片和生存时间值，以及 CancellationToken ICMP 回显消息数据包的缓冲区。
SendPingAsync(IPAddress)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到具有指定 IPAddress数据缓冲区的计算机，并将相应 ICMP 回显答复消息作为异步操作从该计算机接收。
SendPingAsync(String)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到指定计算机，并将相应 ICMP 回显回复消息作为异步操作从该计算机接收。
SendPingAsync(IPAddress, Int32)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到具有指定 IPAddress数据缓冲区的计算机，并将相应 ICMP 回显答复消息作为异步操作从该计算机接收。此重载允许指定操作的超时值。
SendPingAsync(String, Int32)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到指定计算机，并将相应 ICMP 回显回复消息作为异步操作从该计算机接收。此重载允许指定操作的超时值。
SendPingAsync(IPAddress, Int32, Byte[])	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到具有指定 IPAddress数据缓冲区的计算机，并将相应 ICMP 回显答复消息作为异步操作从该计算机接收。此重载允许指定操作的超时值，以及用于发送和接收的缓冲区。
SendPingAsync(String, Int32, Byte[])	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到指定计算机，并将相应 ICMP 回显回复消息作为异步操作从该计算机接收。此重载允许指定操作的超时值，以及用于发送和接收的缓冲区。
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到具有指定 IPAddress数据缓冲区的计算机，并将相应 ICMP 回显答复消息作为异步操作从该计算机接收。此重载允许你为操作指定超时值、用于发送和接收的缓冲区，以及控制 ICMP 回显消息数据包的碎片和生存时间值。
SendPingAsync(String, Int32, Byte[], PingOptions)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到指定计算机，并将相应 ICMP 回显回复消息作为异步操作从该计算机接收。此重载允许你为操作指定超时值、用于发送和接收的缓冲区，以及控制 ICMP 回显消息数据包的碎片和生存时间值。
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)	将具有指定数据缓冲区的 Internet 控制消息协议（ICMP）回显消息发送到具有指定 IPAddress数据缓冲区的计算机，并将相应 ICMP 回显答复消息作为异步操作从该计算机接收。此重载允许指定操作的超时值、用于发送和接收的缓冲区、控制碎片和生存时间值，以及 CancellationToken ICMP 回显消息数据包的缓冲区。

注解

任何 SendPingAsync 方法返回的 IP 地址可能源自恶意远程计算机。不要使用此方式连接到远程计算机。使用 DNS 确定要连接到的计算机的 IP 地址。

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

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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

hostNameOrAddress 是 null。

ArgumentOutOfRangeException

timeout 小于零。

InvalidOperationException

对 SendAsync 方法的调用正在进行中。

PingException

发送或接收 ICMP 消息时引发了异常。有关引发的确切异常，请参阅内部异常。

SocketException

hostNameOrAddress 不是有效的 IP 地址。

ObjectDisposedException

此对象已被释放。

注解

此操作不会阻止。返回 Task<TResult>> 的对象将在发送 ICMP 数据包并接收响应后完成。

适用于

SendPingAsync(IPAddress, Int32, Byte[])

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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

仅限 Linux 上的 .NET 7 及更高版本：进程为非特权， buffer 不为空。

注解

此操作不会阻止。返回 Task<TResult>> 的对象将在发送 ICMP 数据包并接收响应后完成。

适用于

SendPingAsync(String, Int32, Byte[])

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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

仅限 Linux 上的 .NET 7 及更高版本：进程为非特权， buffer 不为空。

注解

此操作不会阻止。返回 Task<TResult>> 的对象将在发送 ICMP 数据包并接收响应后完成。

适用于

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

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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

仅限 Linux 上的 .NET 7 及更高版本：进程为非特权， buffer 不为空。

注解

此操作不会阻止。返回 Task<TResult>> 的对象将在发送 ICMP 数据包并接收响应后完成。

适用于

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

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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

仅限 Linux 上的 .NET 7 及更高版本：进程为非特权， buffer 不为空。

注解

此操作不会阻止。返回 Task<TResult>> 的对象将在发送 ICMP 数据包并接收响应后完成。

适用于

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

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

将具有指定数据缓冲区的 Internet 控制消息协议（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)