Ping.SendPingAsync メソッド

リファレンス

定義

名前空間:: System.Net.NetworkInformation

アセンブリ:: System.Net.Ping.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

非同期操作として、ICMP (インターネット制御メッセージプロトコル) エコーメッセージをコンピューターに送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。

オーバーロード

SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)	指定したデータバッファーを含むインターネット制御メッセージプロトコル (ICMP) エコーメッセージを指定したコンピューターに送信し、そのコンピューターから対応する ICMP エコー応答メッセージを非同期操作として受信します。このオーバーロードを使用すると、操作のタイムアウト値、送受信に使用するバッファー、断片化と Time-to-Live 値の制御、ICMP エコーメッセージパケットのを CancellationToken 指定できます。
SendPingAsync(IPAddress)	非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。
SendPingAsync(String)	非同期操作として、指定されたコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。
SendPingAsync(IPAddress, Int32)	非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値を指定できます。
SendPingAsync(String, Int32)	非同期操作として、指定されたコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値を指定できます。
SendPingAsync(IPAddress, Int32, Byte[])	非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードによって、操作にタイムアウト値を指定し、送信と受信に使用するバッファーを指定することができます。
SendPingAsync(String, Int32, Byte[])	非同期操作として、指定されたコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードによって、操作にタイムアウト値を指定し、送信と受信に使用するバッファーを指定することができます。
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)	非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値と送受信に使用するバッファーを指定し、ICMP エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御できます。
SendPingAsync(String, Int32, Byte[], PingOptions)	非同期操作として、指定されたコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値と送受信に使用するバッファーを指定し、ICMP エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御できます。
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)	非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用すると、操作のタイムアウト値、送受信に使用するバッファー、断片化と Time-to-Live 値の制御、ICMP エコーメッセージパケットのを CancellationToken 指定できます。

注釈

いずれかの SendPingAsync 方法で返される IP アドレスは、悪意のあるリモートコンピューターから送信される可能性があります。これを使用してリモートコンピューターに接続しないでください。 DNS を使用して、接続先のマシンの IP アドレスを確認します。

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

ソース:: Ping.cs

ソース:: Ping.cs

指定したデータバッファーを含むインターネット制御メッセージプロトコル (ICMP) エコーメッセージを指定したコンピューターに送信し、そのコンピューターから対応する ICMP エコー応答メッセージを非同期操作として受信します。このオーバーロードを使用すると、操作のタイムアウト値、送受信に使用するバッファー、断片化と Time-to-Live 値の制御、ICMP エコーメッセージパケットのを CancellationToken 指定できます。

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

ICMP エコーメッセージと共に送信されるデータが格納され、ICMP エコー応答メッセージで返される Byte 配列。配列には、65,500 バイトを超えるデータを格納することはできません。

options: PingOptions

ICMP エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御するために使用される PingOptions オブジェクト。

cancellationToken: CancellationToken

キャンセル要求を監視するためのトークン。既定値は None です。

戻り値

Task<PingReply>

非同期操作を表すタスクオブジェクト。

例外

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

適用対象

SendPingAsync(IPAddress)

ソース:: Ping.cs

ソース:: Ping.cs

ソース:: Ping.cs

非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する 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

ICMP エコーメッセージの送信先コンピューターを識別する IP アドレス。

戻り値

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

非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する 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

ICMP エコーメッセージの送信先コンピューターを識別する IP アドレス。

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 が 0 未満です。

InvalidOperationException

SendAsync メソッドの呼び出しを実行中です。

PingException

ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。

SocketException

address が有効な IP アドレスではありません。

ObjectDisposedException

このオブジェクトは破棄されました。

注釈

この操作はブロックされません。返された Task<TResult>> オブジェクトは、ICMP パケットが送信され、応答が受信された後に完了します。

適用対象

SendPingAsync(IPAddress, Int32, Byte[])

ソース:: Ping.cs

ソース:: Ping.cs

ソース:: Ping.cs

非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する 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

ICMP エコーメッセージの送信先コンピューターを識別する IP アドレス。

timeout: Int32

エコーメッセージを送信してから ICMP エコー応答メッセージを待つ時間の最大値 (ミリ秒単位)。

buffer: Byte[]

戻り値

Task<PingReply>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

address または buffer が null です。

ArgumentOutOfRangeException

timeout が 0 未満です。

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

戻り値

Task<PingReply>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

hostNameOrAddress が null または空の文字列 ("") です。

- または -

buffer は null です。

ArgumentOutOfRangeException

timeout が 0 未満です。

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

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

ICMP エコーメッセージの送信先コンピューターを識別する IP アドレス。

timeout: Int32

エコーメッセージを送信してから ICMP エコー応答メッセージを待つ時間の最大値 (ミリ秒単位)。

buffer: Byte[]

options: PingOptions

ICMP エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御するために使用される PingOptions オブジェクト。

戻り値

Task<PingReply>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

address または buffer が null です。

ArgumentOutOfRangeException

timeout が 0 未満です。

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 エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御できます。

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

options: PingOptions

ICMP エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御するために使用される PingOptions オブジェクト。

戻り値

Task<PingReply>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

hostNameOrAddress が null または空の文字列 ("") です。

- または -

buffer は null です。

ArgumentOutOfRangeException

timeout が 0 未満です。

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

非同期操作として、指定された IPAddress を持つコンピューターに、指定されたデータバッファーと共に ICMP (インターネット制御メッセージプロトコル) エコーメッセージを送信し、そのコンピューターから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用すると、操作のタイムアウト値、送受信に使用するバッファー、断片化と Time-to-Live 値の制御、ICMP エコーメッセージパケットのを CancellationToken 指定できます。

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

ICMP エコーメッセージの送信先コンピューターを識別する IP アドレス。

timeout: TimeSpan

ICMP エコー応答メッセージを待機する時間 (エコーメッセージの送信後)。

buffer: Byte[]

options: PingOptions

ICMP エコーメッセージパケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御するために使用される PingOptions オブジェクト。

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)

パラメーター

戻り値

例外

適用対象

その他のリソース