Ping.SendPingAsync メソッド

定義

名前空間:: System.Net.NetworkInformation

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

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

オーバーロード

名前	説明
SendPingAsync(String, Int32, Byte[], PingOptions)	指定したデータバッファーを含むインターネット制御メッセージプロトコル (ICMP) エコーメッセージを指定されたコンピューターに送信し、そのコンピューターから対応する ICMP エコー応答メッセージを非同期操作として受信します。このオーバーロードを使用すると、操作のタイムアウト値、送受信に使用するバッファーを指定し、ICMP エコーメッセージパケットの断片化と Time-to-Live 値を制御できます。
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 エコーメッセージパケットの断片化と Time-to-Live 値を制御できます。

注釈

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

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

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

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

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

options: PingOptions

ICMP エコーメッセージパケットの断片化と 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)

指定したデータバッファーを含むインターネット制御メッセージプロトコル (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

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

返品

Task<PingReply>

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

例外

ArgumentNullException

address は nullです。

InvalidOperationException

SendPingAsyncの呼び出しが進行中です。

PingException

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

SocketException

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

ObjectDisposedException

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

注釈

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

適用対象

SendPingAsync(String)

指定したデータバッファーを含むインターネット制御メッセージプロトコル (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

返品

Task<PingReply>

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

例外

ArgumentNullException

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

InvalidOperationException

SendAsync(String, Object) メソッドの呼び出しが進行中です。

PingException

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

SocketException

hostNameOrAddress 有効な IP アドレスに解決できませんでした。

ObjectDisposedException

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

注釈

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

適用対象

SendPingAsync(IPAddress, Int32)

指定したデータバッファーを含むインターネット制御メッセージプロトコル (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

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

timeout: Int32

ICMP エコー応答メッセージを待機する最大ミリ秒数 (エコーメッセージの送信後)。

返品

Task<PingReply>

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

例外

ArgumentNullException

address は nullです。

InvalidOperationException

SendAsync メソッドの呼び出しが進行中です。

PingException

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

SocketException

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

ObjectDisposedException

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

注釈

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

適用対象

SendPingAsync(String, Int32)

指定したデータバッファーを含むインターネット制御メッセージプロトコル (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

timeout: Int32

ICMP エコー応答メッセージを待機する最大ミリ秒数 (エコーメッセージの送信後)。

返品

Task<PingReply>

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

例外

ArgumentNullException

hostNameOrAddress は nullです。

ArgumentOutOfRangeException

timeout が 0 未満です。

InvalidOperationException

SendAsync メソッドの呼び出しが進行中です。

PingException

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

SocketException

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

ObjectDisposedException

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

注釈

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

適用対象

SendPingAsync(IPAddress, Int32, Byte[])

指定したデータバッファーを含むインターネット制御メッセージプロトコル (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

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

指定したデータバッファーを含むインターネット制御メッセージプロトコル (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

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)

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

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);

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 エコーメッセージパケットの断片化と 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 パケットが送信され、応答が受信された後に完了します。

適用対象

フィードバック

このページはお役に立ちましたか?