共用方式為


Ping.SendPingAsync 方法

定義

以非同步作業的方式,將網際網路控制訊息通訊協定 (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

傳回

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

例外狀況

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

適用於

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

傳回

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

例外狀況

addressnull

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

address 不是有效的 IP 位址。

這個物件已經過處置。

備註

這項作業不會封鎖。 傳回 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 位址的字串表示。

傳回

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

例外狀況

hostNameOrAddressnull 或空字串 ("")。

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

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

這個物件已經過處置。

備註

這項作業不會封鎖。 傳回 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 回應回覆訊息的最大毫秒數 (在傳送回應訊息之後)。

傳回

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

例外狀況

addressnull

正在呼叫 SendAsync 方法。

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

address 不是有效的 IP 位址。

這個物件已經過處置。

備註

這項作業不會封鎖。 傳回 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 回應回覆訊息的最大毫秒數 (在傳送回應訊息之後)。

傳回

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

例外狀況

addressnull

timeout 小於零。

正在呼叫 SendAsync 方法。

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

address 不是有效的 IP 位址。

這個物件已經過處置。

備註

這項作業不會封鎖。 傳回 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 以上。

傳回

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

例外狀況

addressbuffernull

timeout 小於零。

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

address 不是有效的 IP 位址。

這個物件已經過處置。

buffer 的大小超過 65,500 個位元組。

僅限 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 以上。

傳回

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

例外狀況

hostNameOrAddressnull 或空字串 ("")。

-或-

buffernull

timeout 小於零。

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

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

這個物件已經過處置。

buffer 的大小超過 65500 個位元組。

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

傳回

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

例外狀況

addressbuffernull

timeout 小於零。

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

address 不是有效的 IP 位址。

這個物件已經過處置。

buffer 的大小超過 65,500 個位元組。

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

傳回

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

例外狀況

hostNameOrAddressnull 或空字串 ("")。

-或-

buffernull

timeout 小於零。

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

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

這個物件已經過處置。

buffer 的大小超過 65500 個位元組。

僅限 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

傳回

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

例外狀況

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

適用於