語言

Ping.SendPingAsync 方法

定義

向電腦發送網際網路控制訊息協定(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 回覆訊息所需的時間。

buffer
Byte[]

一個 Byte 陣列,包含要隨 ICMP 回波訊息傳送並在 ICMP 回聲回覆訊息中回傳的資料。 陣列容量不得超過 65,500 位元組。

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 回聲回覆訊息的最大毫秒數。

buffer
Byte[]

一個 Byte 陣列,包含要隨 ICMP 回波訊息傳送並在 ICMP 回聲回覆訊息中回傳的資料。 陣列容量不得超過 65,500 位元組。

傳回

表示異步操作的工作物件。

例外狀況

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 回聲回覆訊息的最大毫秒數。

buffer
Byte[]

一個 Byte 陣列,包含要隨 ICMP 回波訊息傳送並在 ICMP 回聲回覆訊息中回傳的資料。 陣列容量不得超過 65,500 位元組。

傳回

表示異步操作的工作物件。

例外狀況

hostNameOrAddress 是 null 或是空字串(“”)。

-或-

buffer 是 null。

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 回聲回覆訊息的最大毫秒數。

buffer
Byte[]

一個 Byte 陣列,包含要隨 ICMP 回波訊息傳送並在 ICMP 回聲回覆訊息中回傳的資料。 陣列容量不得超過 65,500 位元組。

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 回聲回覆訊息的最大毫秒數。

buffer
Byte[]

一個 Byte 陣列,包含要隨 ICMP 回波訊息傳送並在 ICMP 回聲回覆訊息中回傳的資料。 陣列容量不得超過 65,500 位元組。

options
PingOptions

一個 PingOptions 用於控制 ICMP 回聲訊息封包碎片化及存活時間值的物件。

傳回

表示異步操作的工作物件。

例外狀況

hostNameOrAddress 是 null 或是空字串(“”)。

-或-

buffer 是 null。

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 回覆訊息所需的時間。

buffer
Byte[]

一個 Byte 陣列,包含要隨 ICMP 回波訊息傳送並在 ICMP 回聲回覆訊息中回傳的資料。 陣列容量不得超過 65,500 位元組。

options
PingOptions

一個 PingOptions 用於控制 ICMP 回聲訊息封包碎片化及存活時間值的物件。

cancellationToken
CancellationToken

用來監控取消申請的代幣。 預設值為 None。

傳回

表示異步操作的工作物件。

例外狀況

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

適用於