Ping.SendPingAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
向電腦發送網際網路控制訊息協定(ICMP)迴波訊息,並從該電腦接收相應的ICMP迴波回覆訊息,作為非同步操作。
多載
| 名稱 | Description |
|---|---|
| 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) |
以指定資料緩衝區向擁有指定 IPAddress資料緩衝區的網際網路控制訊息協定(ICMP)回波訊息,並以非同步操作接收該電腦對應的ICMP回波回覆訊息。 此過載允許你指定操作的逾時值、用於傳送與接收的緩衝區,以及控制 ICMP 回波訊息封包的碎片化與存活時間值。 |
| SendPingAsync(String, Int32, Byte[], PingOptions) |
將帶有指定資料緩衝區的網際網路控制訊息協定(ICMP)回聲訊息傳送至指定電腦,並以非同步操作方式接收該電腦對應的 ICMP 回波回覆訊息。 此過載允許你指定操作的逾時值、用於傳送與接收的緩衝區,以及控制 ICMP 回波訊息封包的碎片化與存活時間值。 |
| SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
以指定資料緩衝區向擁有指定 IPAddress資料緩衝區的網際網路控制訊息協定(ICMP)回波訊息,並以非同步操作接收該電腦對應的ICMP回波回覆訊息。 此超載允許你指定操作的逾時值、用於發送與接收的緩衝區、控制分段與存活時間值,以及 CancellationToken ICMP 迴波訊息封包的緩衝區。 |
備註
任何 SendPingAsync 方法回傳的 IP 位址都可能來自惡意遠端電腦。 請勿用此連接遠端電腦。 使用 DNS 來確定你想連接的機器的 IP 位址。
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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
就是在發送 echo 訊息後等待 ICMP echo 回覆訊息所需的時間。
- options
- PingOptions
一個 PingOptions 用於控制 ICMP 回聲訊息封包碎片化及存活時間值的物件。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
表示異步操作的工作物件。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
適用於
SendPingAsync(IPAddress)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 回聲訊息的目的地電腦。
傳回
表示異步操作的工作物件。
例外狀況
address 是 null。
正在進行呼叫 SendPingAsync 。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
address 不是有效的 IP 位址。
此物已被處理。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(String)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 位址的字串表示。
傳回
表示異步操作的工作物件。
例外狀況
hostNameOrAddress 是 null 或是空字串(“”)。
一個叫法 SendAsync(String, Object) 正在進行中。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
hostNameOrAddress 無法解析為有效的 IP 位址。
此物已被處理。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(IPAddress, Int32)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 回聲回覆訊息的最大毫秒數。
傳回
表示異步操作的工作物件。
例外狀況
address 是 null。
目前正在進行對該 SendAsync 方法的呼叫。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
address 不是有效的 IP 位址。
此物已被處理。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(String, Int32)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 回聲回覆訊息的最大毫秒數。
傳回
表示異步操作的工作物件。
例外狀況
hostNameOrAddress 是 null。
timeout 小於零。
目前正在進行對該 SendAsync 方法的呼叫。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
hostNameOrAddress 不是有效的 IP 位址。
此物已被處理。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(IPAddress, Int32, Byte[])
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 回聲回覆訊息的最大毫秒數。
傳回
表示異步操作的工作物件。
例外狀況
address 或 buffer 為 null。
timeout 小於零。
正在進行呼叫 SendPingAsync 。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
address 不是有效的 IP 位址。
此物已被處理。
其大小 buffer 超過 65,500 位元組。
.NET 7 及更新版本僅適用於 Linux:該程序非特權,且 buffer 非空的。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(String, Int32, Byte[])
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 回聲回覆訊息的最大毫秒數。
傳回
表示異步操作的工作物件。
例外狀況
timeout 小於零。
正在進行呼叫 SendAsync 。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
hostNameOrAddress 無法解析為有效的 IP 位址。
此物已被處理。
其大小 buffer 超過 65500 位元組。
.NET 7 及更新版本僅適用於 Linux:該程序非特權,且 buffer 非空的。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- Ping.cs
以指定資料緩衝區向擁有指定 IPAddress資料緩衝區的網際網路控制訊息協定(ICMP)回波訊息,並以非同步操作接收該電腦對應的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 位元組。
.NET 7 及更新版本僅適用於 Linux:該程序非特權,且 buffer 非空的。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(String, Int32, Byte[], PingOptions)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- 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 回聲回覆訊息的最大毫秒數。
- options
- PingOptions
一個 PingOptions 用於控制 ICMP 回聲訊息封包碎片化及存活時間值的物件。
傳回
表示異步操作的工作物件。
例外狀況
timeout 小於零。
正在進行呼叫 SendAsync 。
在發送或接收 ICMP 訊息時會拋出例外。 請參見內部例外,了解被拋出的具體例外。
hostNameOrAddress 無法解析為有效的 IP 位址。
此物已被處理。
其大小 buffer 超過 65500 位元組。
.NET 7 及更新版本僅適用於 Linux:該程序非特權,且 buffer 非空的。
備註
這個行動不會被阻擋。 回傳 Task<TResult>> 物件會在 ICMP 封包發送且回應收到後完成。
適用於
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- Ping.cs
- 來源:
- Ping.cs
以指定資料緩衝區向擁有指定 IPAddress資料緩衝區的網際網路控制訊息協定(ICMP)回波訊息,並以非同步操作接收該電腦對應的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
就是在發送 echo 訊息後等待 ICMP echo 回覆訊息所需的時間。
- options
- PingOptions
一個 PingOptions 用於控制 ICMP 回聲訊息封包碎片化及存活時間值的物件。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
表示異步操作的工作物件。
例外狀況
取消令牌也被取消了。 此例外會儲存在回傳的任務中。