Ping.SendPingAsync 方法

定义

将 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

将 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

返回

表示异步操作的任务对象。

例外

取消令牌已取消。 此异常存储在返回的任务中。

适用于

SendPingAsync(IPAddress)

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 回送消息目标的计算机。

返回

表示异步操作的任务对象。

例外

addressnull

SendPingAsync 的调用正在进行中。

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

address 不是有效的 IP 地址。

已释放此对象。

注解

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

适用于

SendPingAsync(String)

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 地址。

返回

表示异步操作的任务对象。

例外

hostNameOrAddressnull 或是一个空字符串 ("")。

SendAsync(String, Object) 方法的调用正在进行中。

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

hostNameOrAddress 未能解析为有效的 IP 地址。

已释放此对象。

注解

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

适用于

SendPingAsync(IPAddress, Int32)

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 回送答复消息的最大毫秒数。

返回

表示异步操作的任务对象。

例外

addressnull

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

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

address 不是有效的 IP 地址。

已释放此对象。

注解

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

适用于

SendPingAsync(String, Int32)

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 回送答复消息的最大毫秒数。

返回

表示异步操作的任务对象。

例外

addressnull

timeout 小于零。

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

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

address 不是有效的 IP 地址。

已释放此对象。

注解

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

适用于

SendPingAsync(IPAddress, Int32, Byte[])

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 个字节。

返回

表示异步操作的任务对象。

例外

addressbuffernull

timeout 小于零。

SendPingAsync 的调用正在进行中。

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

address 不是有效的 IP 地址。

已释放此对象。

buffer 的大小超过 65,500 字节。

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

注解

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

适用于

SendPingAsync(String, Int32, Byte[])

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 个字节。

返回

表示异步操作的任务对象。

例外

hostNameOrAddressnull 或是一个空字符串 ("")。

- 或 -

buffernull

timeout 小于零。

SendAsync 的调用正在进行中。

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

hostNameOrAddress 未能解析为有效的 IP 地址。

已释放此对象。

buffer 的大小超过 65500 字节。

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

注解

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

适用于

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

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 回显消息数据包的碎片和生存时间值。

返回

表示异步操作的任务对象。

例外

addressbuffernull

timeout 小于零。

SendPingAsync 的调用正在进行中。

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

address 不是有效的 IP 地址。

已释放此对象。

buffer 的大小超过 65,500 字节。

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

注解

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

适用于

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

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 回显消息数据包的碎片和生存时间值。

返回

表示异步操作的任务对象。

例外

hostNameOrAddressnull 或是一个空字符串 ("")。

- 或 -

buffernull

timeout 小于零。

SendAsync 的调用正在进行中。

发送或接收 ICMP 消息时引发异常。 请参见内部异常,以确切地了解所引发的异常。

hostNameOrAddress 未能解析为有效的 IP 地址。

已释放此对象。

buffer 的大小超过 65500 字节。

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

注解

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

适用于

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

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)

参数

address
IPAddress

一个 IP 地址,它标识作为 ICMP 回送消息目标的计算机。

timeout
TimeSpan

发送回显消息后 () 等待 ICMP 回显回复消息的时间量。

buffer
Byte[]

一个 Byte 数组,它包含要与 ICMP 回送消息一起发送并在 ICMP 回送应答消息中返回的数据。 该数组包含的字节数不能超过 65,500 个字节。

options
PingOptions

一个 PingOptions 对象,用于控制 ICMP 回显消息数据包的碎片和生存时间值。

cancellationToken
CancellationToken

要监视取消请求的标记。 默认值为 None

返回

表示异步操作的任务对象。

例外

取消令牌已取消。 此异常存储在返回的任务中。

适用于