Ping.SendPingAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
将 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 回显回复消息的时间量。
- 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 回送消息目标的计算机。
返回
表示异步操作的任务对象。
例外
address
为 null
。
对 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 地址。
返回
表示异步操作的任务对象。
例外
hostNameOrAddress
为 null
或是一个空字符串 ("")。
对 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 回送答复消息的最大毫秒数。
返回
表示异步操作的任务对象。
例外
address
为 null
。
对 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 回送答复消息的最大毫秒数。
返回
表示异步操作的任务对象。
例外
address
为 null
。
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 回送答复消息的最大毫秒数。
返回
表示异步操作的任务对象。
例外
address
或 buffer
为 null
。
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 回送答复消息的最大毫秒数。
返回
表示异步操作的任务对象。
例外
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 回送答复消息的最大毫秒数。
- options
- PingOptions
一个 PingOptions 对象,用于控制 ICMP 回显消息数据包的碎片和生存时间值。
返回
表示异步操作的任务对象。
例外
address
或 buffer
为 null
。
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 回送答复消息的最大毫秒数。
- options
- PingOptions
一个 PingOptions 对象,用于控制 ICMP 回显消息数据包的碎片和生存时间值。
返回
表示异步操作的任务对象。
例外
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 回显回复消息的时间量。
- options
- PingOptions
一个 PingOptions 对象,用于控制 ICMP 回显消息数据包的碎片和生存时间值。
- cancellationToken
- CancellationToken
要监视取消请求的标记。 默认值为 None。
返回
表示异步操作的任务对象。
例外
取消令牌已取消。 此异常存储在返回的任务中。