Ping.SendPingAsync 方法

參考

定義

命名空間:: System.Net.NetworkInformation

組件:: System.Net.Ping.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

以非同步作業的方式，將網際網路控制訊息通訊協定 (ICMP) 回應訊息傳送給電腦，並從該電腦接收對應的 ICMP 回應回覆訊息。

多載

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)	使用指定資料緩衝區傳送網際網路控制訊息通訊協定 (ICMP) 回應訊息到具有指定 IPAddress 的電腦，並以非同步作業方式接收來自該電腦的對應 ICMP 回應訊息。這個多載可以讓您指定作業的逾時值、用於傳送和接收作業的緩衝區，以及控制 ICMP 回應訊息封包的分散和存留時間值。
SendPingAsync(String, Int32, Byte[], PingOptions)	以非同步作業的方式，將網際網路控制訊息通訊協定 (ICMP) 回應訊息，連同指定的資料緩衝區一起傳送給指定的電腦，並從該電腦接收對應的 ICMP 回應的回覆訊息。這個多載可以讓您指定作業的逾時值、用於傳送和接收作業的緩衝區，以及控制 ICMP 回應訊息封包的分散和存留時間值。
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)	使用指定資料緩衝區傳送網際網路控制訊息通訊協定 (ICMP) 回應訊息到具有指定 IPAddress 的電腦，並以非同步作業方式接收來自該電腦的對應 ICMP 回應訊息。此多載可讓您指定作業的逾時值、用於傳送和接收的緩衝區、控制片段和存留時間值，以及 CancellationToken ICMP 回應訊息封包的。

備註

任何 SendPingAsync 方法所傳回的IP位址都可能源自惡意遠端電腦。請勿使用此連線到遠端電腦。使用 DNS 來判斷您要連線之電腦的 IP 位址。

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

來源:: 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

傳送回應訊息) 等候ICMP回應回覆訊息之後 (的時間量。

buffer: Byte[]

Byte 陣列，包含要與 ICMP 回應訊息一同傳送以及要在 ICMP 回應回覆訊息中傳回的資料。陣列的位元組不可以超過 65,500 以上。

options: PingOptions

PingOptions 物件，用來控制 ICMP 回應訊息封包的分散和存留時間值。

cancellationToken: CancellationToken

用來監視是否有取消要求的語彙基元。預設值是 None。

傳回

Task<PingReply>

工作物件，表示非同步作業。

例外狀況

OperationCanceledException

取消標記已取消。此例外狀況會儲存在傳回的工作中。

適用於

SendPingAsync(IPAddress)

來源:: 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 回應訊息的目標電腦。

傳回

Task<PingReply>

工作物件，表示非同步作業。

例外狀況

ArgumentNullException

address 為 null。

InvalidOperationException

正在呼叫 SendPingAsync。

PingException

傳送或接收 ICMP 訊息時發生例外狀況。查看被擲回之例外狀況的內部真正例外狀況。

SocketException

address 不是有效的 IP 位址。

ObjectDisposedException

這個物件已經過處置。

備註

這項作業不會封鎖。傳回 Task<TResult>> 的物件會在傳送ICMP封包並收到回應之後完成。

適用於

SendPingAsync(String)

來源:: 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 位址的字串表示。

傳回

Task<PingReply>

工作物件，表示非同步作業。

例外狀況

ArgumentNullException

hostNameOrAddress 是 null 或空字串 ("")。

InvalidOperationException

正在呼叫 SendAsync(String, Object) 方法。

PingException

傳送或接收 ICMP 訊息時發生例外狀況。查看被擲回之例外狀況的內部真正例外狀況。

SocketException

hostNameOrAddress 無法解析成有效的 IP 位址。

ObjectDisposedException

這個物件已經過處置。

備註

這項作業不會封鎖。傳回 Task<TResult>> 的物件會在傳送ICMP封包並收到回應之後完成。

適用於

SendPingAsync(IPAddress, Int32)

來源:: 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 回應回覆訊息的最大毫秒數 (在傳送回應訊息之後)。

傳回

Task<PingReply>

工作物件，表示非同步作業。

例外狀況

ArgumentNullException

address 為 null。

InvalidOperationException

正在呼叫 SendAsync 方法。

PingException

傳送或接收 ICMP 訊息時發生例外狀況。查看被擲回之例外狀況的內部真正例外狀況。

SocketException

address 不是有效的 IP 位址。

ObjectDisposedException

這個物件已經過處置。

備註

這項作業不會封鎖。傳回 Task<TResult>> 的物件會在傳送ICMP封包並收到回應之後完成。

適用於

SendPingAsync(String, Int32)

來源:: 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 回應回覆訊息的最大毫秒數 (在傳送回應訊息之後)。

傳回

Task<PingReply>

工作物件，表示非同步作業。

例外狀況

ArgumentNullException

address 為 null。

ArgumentOutOfRangeException

timeout 小於零。

InvalidOperationException

正在呼叫 SendAsync 方法。

PingException

傳送或接收 ICMP 訊息時發生例外狀況。查看被擲回之例外狀況的內部真正例外狀況。

SocketException

address 不是有效的 IP 位址。

ObjectDisposedException

這個物件已經過處置。

備註

這項作業不會封鎖。傳回 Task<TResult>> 的物件會在傳送ICMP封包並收到回應之後完成。

適用於

SendPingAsync(IPAddress, Int32, Byte[])

來源:: 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 以上。

傳回

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[])

來源:: 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 以上。

傳回

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)

來源:: Ping.cs

來源:: Ping.cs

來源:: Ping.cs

使用指定資料緩衝區傳送網際網路控制訊息通訊協定 (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)

來源:: 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 回應訊息封包的分散和存留時間值。

傳回

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)

來源:: Ping.cs

來源:: Ping.cs

使用指定資料緩衝區傳送網際網路控制訊息通訊協定 (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。

傳回

Task<PingReply>

工作物件，表示非同步作業。

例外狀況

OperationCanceledException

取消標記已取消。此例外狀況會儲存在傳回的工作中。

適用於

共用方式為

Ping.SendPingAsync 方法

定義

多載

備註

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

參數

傳回

例外狀況

適用於

SendPingAsync(IPAddress)

參數

傳回

例外狀況

備註

適用於

SendPingAsync(String)

參數

傳回

例外狀況

備註

適用於

SendPingAsync(IPAddress, Int32)

參數

傳回

例外狀況

備註

適用於

SendPingAsync(String, Int32)

參數

傳回

例外狀況

備註

適用於

SendPingAsync(IPAddress, Int32, Byte[])

參數

傳回

例外狀況

備註

適用於

SendPingAsync(String, Int32, Byte[])

參數

傳回

例外狀況

備註

適用於

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

參數

傳回

例外狀況

備註

適用於

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

參數

傳回

例外狀況

備註

適用於

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

參數

傳回

例外狀況

適用於

其他資源