Ping.Send メソッド

.NET Framework クラス ライブラリ リファレンス

Ping.Send メソッド (String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージを指定されたコンピュータに送信し、そのコンピュータから対応する ICMP エコー応答メッセージを受信します。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    hostNameOrAddress As String _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim hostNameOrAddress As String
Dim returnValue As PingReply

returnValue = instance.Send(hostNameOrAddress)

C#

public PingReply Send (
    string hostNameOrAddress
)

C++

public:
PingReply^ Send (
    String^ hostNameOrAddress
)

J#

public PingReply Send (
    String hostNameOrAddress
)

JScript

public function Send (
    hostNameOrAddress : String
) : PingReply

パラメータ

hostNameOrAddress

ICMP エコー メッセージの送信先コンピュータを識別する String。このパラメータの値には、ホスト名または IP アドレスの文字列形式を指定できます。

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。

例外

例外の種類	条件
ArgumentNullException	hostNameOrAddress が null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
NotSupportedException	address は IPv6 アドレスですが、ローカル コンピュータでは Windows 2000 より前のオペレーティング システムが動作しています。
PingException	ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。
SocketException	hostNameOrAddress を有効な IP アドレスに解決できませんでした。
ObjectDisposedException	このオブジェクトは破棄されています。

解説

このメソッドは、32 Byte のデータ バッファを ICMP エコー メッセージと共に送信します。このメソッドは、ICMP エコー応答メッセージを 5 秒間待ちます。その時間内に応答を受信しない場合はメソッドから制御が戻り、Status プロパティに TimedOut が設定されます。

このオーバーロードでは、パケットのフラグメンテーションと転送に既定の設定が使用されます。ICMP エコー メッセージが格納されたパケットは、合計パケット サイズが、1 つのルーティング ノードがローカル コンピュータとリモート コンピュータ間で送信できる最大パケット サイズを超えた場合、途中で分割される場合があります。断片化を防ぐには、options パラメータを受け取る、Send のいずれかのメソッドを使用し、DontFragment プロパティを true に設定します。DontFragment が true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。パケットまたはパケット フラグメント (分割されていた場合) は、破棄されるまでに、ルーティング ノードによって最大 128 回転送されます。この設定を変更するには、options パラメータを受け取る Send のオーバーロードを使用し、Ttl プロパティを必要な値に設定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

メソッドの呼び出しについては、次のコード例を参照してください。

C#

public static void SimplePing
 ()
{
    Ping pingSender = new Ping ();
    PingReply reply = pingSender.Send ("www.contoso.com");

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (String, Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージを指定されたコンピュータに送信し、そのコンピュータから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値を指定できます。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    hostNameOrAddress As String, _
    timeout As Integer _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim hostNameOrAddress As String
Dim timeout As Integer
Dim returnValue As PingReply

returnValue = instance.Send(hostNameOrAddress, timeout)

C#

public PingReply Send (
    string hostNameOrAddress,
    int timeout
)

C++

public:
PingReply^ Send (
    String^ hostNameOrAddress, 
    int timeout
)

J#

public PingReply Send (
    String hostNameOrAddress, 
    int timeout
)

JScript

public function Send (
    hostNameOrAddress : String, 
    timeout : int
) : PingReply

パラメータ

hostNameOrAddress

ICMP エコー メッセージの送信先コンピュータを識別する String。このパラメータの値には、ホスト名または IP アドレスの文字列形式を指定できます。

timeout

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

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。

例外

例外の種類	条件
ArgumentNullException	hostNameOrAddress が null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。
ArgumentOutOfRangeException	timeout が 0 未満です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
SocketException	hostNameOrAddress を有効な IP アドレスに解決できませんでした。
ObjectDisposedException	このオブジェクトは破棄されています。

解説

timeout パラメータによって指定された時間以内に ICMP エコー応答メッセージが受信されなかった場合、ICMP エコーは失敗し、Status プロパティに TimedOut が設定されます。

メモ
timeout に指定した数値が非常に小さい場合、timeout のミリ秒数が経過した後に Ping の応答が受信されることもあります。

このオーバーロードでは、パケットのフラグメンテーションと転送に既定の設定が使用されます。ICMP エコー メッセージが格納されたパケットは、合計パケット サイズが、1 つのルーティング ノードがローカル コンピュータとリモート コンピュータ間で送信できる最大パケット サイズを超えた場合、途中で分割される場合があります。断片化を防ぐには、options パラメータを受け取る、Send のいずれかのメソッドを使用し、DontFragment プロパティを true に設定します。DontFragment が true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。パケットまたはパケット フラグメント (分割されていた場合) は、破棄されるまでに、ルーティング ノードによって最大 128 回転送されます。この設定を変更するには、options パラメータを受け取る Send のオーバーロードを使用し、Ttl プロパティを必要な値に設定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

Send オーバーロードの呼び出しを示すコード例については、Ping クラスの概要を参照してください。

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (IPAddress)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した IPAddress を持つコンピュータに ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージを送信し、そのコンピュータから対応する ICMP エコー応答メッセージを受信します。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    address As IPAddress _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim address As IPAddress
Dim returnValue As PingReply

returnValue = instance.Send(address)

C#

public PingReply Send (
    IPAddress address
)

C++

public:
PingReply^ Send (
    IPAddress^ address
)

J#

public PingReply Send (
    IPAddress address
)

JScript

public function Send (
    address : IPAddress
) : PingReply

パラメータ

address

ICMP エコー メッセージの送信先コンピュータを識別する IPAddress。

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラー原因の説明を提供する PingReply オブジェクト。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
NotSupportedException	address は IPv6 アドレスですが、ローカル コンピュータでは Windows 2000 より前のオペレーティング システムが動作しています。
PingException	ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。
SocketException	address が有効な IP アドレスではありません。
ObjectDisposedException	このオブジェクトは破棄されています。

解説

このメソッドは、address で指定されるホストに、32 Byte のデータ バッファを ICMP エコー メッセージと共に送信します。このメソッドは、ICMP エコー応答メッセージを 5 秒間待ちます。その時間内に応答を受信しない場合はメソッドから制御が戻り、Status プロパティに TimedOut が設定されます。

このオーバーロードでは、パケットのフラグメンテーションと転送に既定の設定が使用されます。ICMP エコー メッセージが格納されたパケットは、合計パケット サイズが、1 つのルーティング ノードがローカル コンピュータとリモート コンピュータ間で送信できる最大パケット サイズを超えた場合、途中で分割される場合があります。断片化を防ぐには、options パラメータを受け取る、Send のいずれかのメソッドを使用し、DontFragment プロパティを true に設定します。DontFragment が true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。パケットまたはパケット フラグメント (分割されていた場合) は、破棄されるまでに、ルーティング ノードによって最大 128 回転送されます。この設定を変更するには、options パラメータを受け取る Send のオーバーロードを使用し、Ttl プロパティを必要な値に設定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

メソッドの呼び出しについては、次のコード例を参照してください。

C#

public static void LocalPing
 ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;
    PingReply reply = pingSender.Send (address);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (IPAddress, Int32, Byte[])

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    address As IPAddress, _
    timeout As Integer, _
    buffer As Byte() _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim address As IPAddress
Dim timeout As Integer
Dim buffer As Byte()
Dim returnValue As PingReply

returnValue = instance.Send(address, timeout, buffer)

C#

public PingReply Send (
    IPAddress address,
    int timeout,
    byte[] buffer
)

C++

public:
PingReply^ Send (
    IPAddress^ address, 
    int timeout, 
    array<unsigned char>^ buffer
)

J#

public PingReply Send (
    IPAddress address, 
    int timeout, 
    byte[] buffer
)

JScript

public function Send (
    address : IPAddress, 
    timeout : int, 
    buffer : byte[]
) : PingReply

パラメータ

address

ICMP エコー メッセージの送信先コンピュータを識別する IPAddress。

timeout

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

buffer

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

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。パケットが MTU (Maximum Transmission Unit) を超えている場合、このメソッドは PacketTooBig を返します。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。 または buffer が null 参照 (Visual Basic では Nothing) です。または、buffer のサイズが 65500 バイトを超えています。
ArgumentOutOfRangeException	timeout が 0 未満です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
NotSupportedException	address は IPv6 アドレスですが、ローカル コンピュータでは Windows 2000 より前のオペレーティング システムが動作しています。
PingException	ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。
SocketException	address が有効な IP アドレスではありません。
ObjectDisposedException	このオブジェクトは破棄されています。
ArgumentException	buffer のサイズが 65500 バイトを超えています。

解説

timeout パラメータによって指定された時間以内に ICMP エコー応答メッセージが受信されなかった場合、ICMP エコーは失敗し、Status プロパティに TimedOut が設定されます。

メモ
timeout に指定した数値が非常に小さい場合、timeout のミリ秒数が経過した後に Ping の応答が受信されることもあります。

このオーバーロードでは、パケットのフラグメンテーションと転送に既定の設定が使用されます。ICMP エコー メッセージが格納されたパケットは、合計パケット サイズが、1 つのルーティング ノードがローカル コンピュータとリモート コンピュータ間で送信できる最大パケット サイズを超えた場合、途中で分割される場合があります。断片化を防ぐには、options パラメータを受け取る、Send のいずれかのメソッドを使用し、DontFragment プロパティを true に設定します。DontFragment が true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。

パケットまたはパケット フラグメントは、破棄されるまでに、ルーティング ノードによって最大 128 回転送されます。この設定を変更するには、options パラメータを受け取る Send のオーバーロードを使用し、Ttl プロパティを必要な値に設定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

このメソッドを呼び出す方法を次のコード例に示します。

C#

public static void LocalPingTimeout
 ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;
    PingReply reply = pingSender.Send (address, timeout, buffer);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (String, Int32, Byte[])

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたデータ バッファと共に ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージを指定されたコンピュータに送信し、そのコンピュータから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値を指定できます。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    hostNameOrAddress As String, _
    timeout As Integer, _
    buffer As Byte() _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim hostNameOrAddress As String
Dim timeout As Integer
Dim buffer As Byte()
Dim returnValue As PingReply

returnValue = instance.Send(hostNameOrAddress, timeout, buffer)

C#

public PingReply Send (
    string hostNameOrAddress,
    int timeout,
    byte[] buffer
)

C++

public:
PingReply^ Send (
    String^ hostNameOrAddress, 
    int timeout, 
    array<unsigned char>^ buffer
)

J#

public PingReply Send (
    String hostNameOrAddress, 
    int timeout, 
    byte[] buffer
)

JScript

public function Send (
    hostNameOrAddress : String, 
    timeout : int, 
    buffer : byte[]
) : PingReply

パラメータ

hostNameOrAddress

ICMP エコー メッセージの送信先コンピュータを識別する String。このパラメータの値には、ホスト名または IP アドレスの文字列形式を指定できます。

timeout

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

buffer

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

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。

例外

例外の種類	条件
ArgumentNullException	hostNameOrAddress が null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。 または buffer が null 参照 (Visual Basic では Nothing) です。または、buffer のサイズが 65500 バイトを超えています。
ArgumentOutOfRangeException	timeout が 0 未満です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
SocketException	hostNameOrAddress を有効な IP アドレスに解決できませんでした。
ObjectDisposedException	このオブジェクトは破棄されています。
ArgumentException	buffer のサイズが 65500 バイトを超えています。

解説

timeout パラメータによって指定された時間以内に ICMP エコー応答メッセージが受信されなかった場合、ICMP エコーは失敗し、Status プロパティに TimedOut が設定されます。

メモ
timeout に指定した数値が非常に小さい場合、timeout のミリ秒数が経過した後に Ping の応答が受信されることもあります。

このオーバーロードでは、パケットのフラグメンテーションと転送に既定の設定が使用されます。ICMP エコー メッセージが格納されたパケットは、合計パケット サイズが、1 つのルーティング ノードがローカル コンピュータとリモート コンピュータ間で送信できる最大パケット サイズを超えた場合、途中で分割される場合があります。断片化を防ぐには、options パラメータを受け取る、Send のいずれかのメソッドを使用し、DontFragment プロパティを true に設定します。DontFragment が true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。

パケットまたはパケット フラグメントは、破棄されるまでに、ルーティング ノードによって最大 128 回転送されます。この設定を変更するには、options パラメータを受け取る Send のオーバーロードを使用し、Ttl プロパティを必要な値に設定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

Send オーバーロードの呼び出し方法を示すコード例については、Ping クラスの概要を参照してください。

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (IPAddress, Int32, Byte[], PingOptions)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定された IPAddress を持つコンピュータに、指定されたデータ バッファと共に ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージを送信し、そのコンピュータから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値を指定し、ICMP エコー メッセージ パケットのフラグメンテーションと有効期間 (TTL: time-to-live) の値を制御できます。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    address As IPAddress, _
    timeout As Integer, _
    buffer As Byte(), _
    options As PingOptions _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim address As IPAddress
Dim timeout As Integer
Dim buffer As Byte()
Dim options As PingOptions
Dim returnValue As PingReply

returnValue = instance.Send(address, timeout, buffer, options)

C#

public PingReply Send (
    IPAddress address,
    int timeout,
    byte[] buffer,
    PingOptions options
)

C++

public:
PingReply^ Send (
    IPAddress^ address, 
    int timeout, 
    array<unsigned char>^ buffer, 
    PingOptions^ options
)

J#

public PingReply Send (
    IPAddress address, 
    int timeout, 
    byte[] buffer, 
    PingOptions options
)

JScript

public function Send (
    address : IPAddress, 
    timeout : int, 
    buffer : byte[], 
    options : PingOptions
) : PingReply

パラメータ

address

ICMP エコー メッセージの送信先コンピュータを識別する IPAddress。

timeout

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

buffer

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

options

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

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。パケットが MTU (Maximum Transmission Unit) を超えている場合、このメソッドは PacketTooBig を返します。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。 または buffer が null 参照 (Visual Basic では Nothing) です。または、buffer のサイズが 65500 バイトを超えています。
ArgumentOutOfRangeException	timeout が 0 未満です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
NotSupportedException	address は IPv6 アドレスですが、ローカル コンピュータでは Windows 2000 より前のオペレーティング システムが動作しています。
PingException	ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。
SocketException	address が有効な IP アドレスではありません。
ObjectDisposedException	このオブジェクトは破棄されています。
ArgumentException	buffer のサイズが 65500 バイトを超えています。

解説

timeout パラメータによって指定された時間以内に ICMP エコー応答メッセージが受信されなかった場合、ICMP エコーは失敗し、Status プロパティに TimedOut が設定されます。

メモ
timeout に指定した数値が非常に小さい場合、timeout のミリ秒数が経過した後に Ping の応答が受信されることもあります。

DontFragment プロパティが true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。

Ttl プロパティを使用して、送信先に到達するまでに ICMP エコー メッセージを転送できる最大の回数を指定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

このメソッドを呼び出す方法を次のコード例に示します。

C#

public static void ComplexLocalPing
 ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);
    PingReply reply = pingSender.Send (address, timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (String, Int32, Byte[], PingOptions)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたデータ バッファと共に ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージを指定されたコンピュータに送信し、そのコンピュータから対応する ICMP エコー応答メッセージを受信します。このオーバーロードを使用して、操作のタイムアウト値を指定し、ICMP パケットのフラグメンテーションと有効期間 (TTL: time-to-live) 値を制御できます。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    hostNameOrAddress As String, _
    timeout As Integer, _
    buffer As Byte(), _
    options As PingOptions _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim hostNameOrAddress As String
Dim timeout As Integer
Dim buffer As Byte()
Dim options As PingOptions
Dim returnValue As PingReply

returnValue = instance.Send(hostNameOrAddress, timeout, buffer, options)

C#

public PingReply Send (
    string hostNameOrAddress,
    int timeout,
    byte[] buffer,
    PingOptions options
)

C++

public:
PingReply^ Send (
    String^ hostNameOrAddress, 
    int timeout, 
    array<unsigned char>^ buffer, 
    PingOptions^ options
)

J#

public PingReply Send (
    String hostNameOrAddress, 
    int timeout, 
    byte[] buffer, 
    PingOptions options
)

JScript

public function Send (
    hostNameOrAddress : String, 
    timeout : int, 
    buffer : byte[], 
    options : PingOptions
) : PingReply

パラメータ

hostNameOrAddress

ICMP エコー メッセージの送信先コンピュータを識別する String。このパラメータの値には、ホスト名または IP アドレスの文字列形式を指定できます。

timeout

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

buffer

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

options

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

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。

例外

例外の種類	条件
ArgumentNullException	hostNameOrAddress が null 参照 (Visual Basic では Nothing) かまたは長さ 0 の文字列です。 または buffer が null 参照 (Visual Basic では Nothing) です。または、buffer のサイズが 65500 バイトを超えています。
ArgumentOutOfRangeException	timeout が 0 未満です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
NotSupportedException	address は IPv6 アドレスですが、ローカル コンピュータでは Windows 2000 より前のオペレーティング システムが動作しています。
PingException	ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。
SocketException	hostNameOrAddress を有効な IP アドレスに解決できませんでした。
ObjectDisposedException	このオブジェクトは破棄されています。
ArgumentException	buffer のサイズが 65500 バイトを超えています。

解説

timeout パラメータによって指定された時間以内に ICMP エコー応答メッセージが受信されなかった場合、ICMP エコーは失敗し、Status プロパティに TimedOut が設定されます。

メモ
timeout に指定した数値が非常に小さい場合、timeout のミリ秒数が経過した後に Ping の応答が受信されることもあります。

DontFragment プロパティが true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。

Ttl プロパティを使用して、送信先に到達するまでに ICMP エコー メッセージを転送できる最大の回数を指定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

このメソッドを呼び出す方法を次のコード例に示します。

C#

public static void ComplexPing
 ()
{
    Ping pingSender = new Ping ();

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);

    // Send the request.
    PingReply reply = pingSender.Send ("www.contoso.com", timeout, buffer,
 options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド

ICMP (インターネット コントロール メッセージ プロトコル) エコー メッセージをリモート コンピュータに送信し、そのリモート コンピュータから対応する ICMP エコー応答メッセージを受信します。
オーバーロードの一覧

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

参照

関連項目

Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間

Ping.Send メソッド (IPAddress, Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Send ( _
    address As IPAddress, _
    timeout As Integer _
) As PingReply

Visual Basic (使用法)

Dim instance As Ping
Dim address As IPAddress
Dim timeout As Integer
Dim returnValue As PingReply

returnValue = instance.Send(address, timeout)

C#

public PingReply Send (
    IPAddress address,
    int timeout
)

C++

public:
PingReply^ Send (
    IPAddress^ address, 
    int timeout
)

J#

public PingReply Send (
    IPAddress address, 
    int timeout
)

JScript

public function Send (
    address : IPAddress, 
    timeout : int
) : PingReply

パラメータ

address

ICMP エコー メッセージの送信先コンピュータを識別する IPAddress。

timeout

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

戻り値
ICMP エコー応答メッセージが受信された場合は、そのメッセージに関する情報を提供し、メッセージが受信されなかった場合は、エラーの原因を提供する PingReply オブジェクト。

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	timeout が 0 未満です。
InvalidOperationException	SendAsync の呼び出しを実行中です。
NotSupportedException	address は IPv6 アドレスですが、ローカル コンピュータでは Windows 2000 より前のオペレーティング システムが動作しています。
PingException	ICMP メッセージの送信中または受信中に例外がスローされました。スローされた実際の例外については内部例外を参照してください。
SocketException	address が有効な IP アドレスではありません。
ObjectDisposedException	このオブジェクトは破棄されています。

解説

timeout パラメータによって指定された時間以内に ICMP エコー応答メッセージが受信されなかった場合、ICMP エコーは失敗し、Status プロパティに TimedOut が設定されます。

メモ
timeout に指定した数値が非常に小さい場合、timeout のミリ秒数が経過した後に Ping の応答が受信されることもあります。

このオーバーロードでは、パケットのフラグメンテーションと転送に既定の設定が使用されます。ICMP エコー メッセージが格納されたパケットは、合計パケット サイズが、1 つのルーティング ノードがローカル コンピュータとリモート コンピュータ間で送信できる最大パケット サイズを超えた場合、途中で分割される場合があります。断片化を防ぐには、options パラメータを受け取る、Send のいずれかのメソッドを使用し、DontFragment プロパティを true に設定します。DontFragment が true のときに、合計パケット サイズが、ローカル コンピュータとリモート コンピュータの間にあるいずれかのルーティング ノードで送信できる最大パケット サイズを超えた場合、ICMP エコー要求は失敗します。これが発生した場合、Status は PacketTooBig に設定されます。

パケットまたはパケット フラグメントは、破棄されるまでに、ルーティング ノードによって最大 128 回転送されます。この設定を変更するには、options パラメータを受け取る Send のオーバーロードを使用し、Ttl プロパティを必要な値に設定します。パケットが指定回数転送されても送信先に到達しなかった場合、パケットは破棄され、ICMP エコー要求は失敗します。これが発生した場合、Status は TtlExpired に設定されます。

使用例

Send オーバーロードの呼び出しを示すコード例については、Ping クラスの概要を参照してください。

.NET Framework のセキュリティ

• NetworkInformationPermission  (ICMP エコー メッセージを送信するために必要なアクセス許可)。 Ping (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Ping クラス
Ping メンバ
System.Net.NetworkInformation 名前空間