PingReply.Options プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

PingReply.Options プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ICMP (インターネットコントロールメッセージプロトコル) エコー要求に応答を送信するために使用するオプションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Options As PingOptions

Visual Basic (使用法)

Dim instance As PingReply
Dim value As PingOptions

value = instance.Options

public PingOptions Options { get; }

C++

public:
property PingOptions^ Options {
    PingOptions^ get ();
}

/** @property */
public PingOptions get_Options ()

JScript

public function get Options
 () : PingOptions

プロパティ値
Status が Success の場合は、応答の送信に使用する有効期間 (TTL: Time to Live) とフラグメンテーションディレクティブを格納した PingOptions オブジェクト。それ以外の場合は null 参照 (Visual Basic では Nothing)。

解説

TTL は、送信元と送信先の間をパケットが伝送される際にノードがパケットを転送できる回数を定義します。転送の回数 (ホップ数) が、TTL に指定された値を超えた場合、そのパケットは配送不可能と判断され、破棄されます。

ICMP エコー要求に指定される DontFragment の値は、パケットのフラグメンテーションを制御します。DontFragment が true の場合、パケットが通過するネットワークパスの MTU (Maximum Transmission Unit) をパケットサイズが超えると、そのパケットは破棄され、PacketTooBig エラーが返されます。

使用例

ICMP エコー要求を同期的に送信し、このプロパティによって返される PingOptions オブジェクトに格納された値を表示するコード例を次に示します。

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