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

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

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

Socket.DontFragment プロパティ

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

Socket でインターネットプロトコル (IP) データグラムの断片化を許可するかどうかを指定する Boolean 値を、取得または設定します。

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

Visual Basic (宣言)

Public Property DontFragment As
 Boolean

Visual Basic (使用法)

Dim instance As Socket
Dim value As Boolean

value = instance.DontFragment

instance.DontFragment = value

public bool DontFragment { get;
 set; }

C++

public:
property bool DontFragment {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_DontFragment ()

/** @property */
public void set_DontFragment (boolean value)

JScript

public function get DontFragment
 () : boolean

public function set DontFragment
 (value : boolean)

プロパティ値
Socket でデータグラムの断片化を許可する場合は true。それ以外の場合は false。既定値は true です。

例外

例外の種類	条件
NotSupportedException	このプロパティは、InterNetwork ファミリまたは InterNetworkV6 ファミリのソケットに対してだけ設定できます。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。

解説

データグラムのサイズが伝送メディアの MTU (Maximum Transmission Unit) を超える場合は、分割する必要があります。データグラムは送信元のホスト (すべてのインターネットプロトコルバージョン) によって分割される場合と、中継ルーター (インターネットプロトコル Version 4 のみ) によって分割される場合があります。データグラムを分割する必要がある場合に DontFragment オプションが設定されていると、データグラムは破棄され、インターネットコントロールメッセージプロトコル (ICMP) エラーメッセージがデータグラムの送信元に返されます。

伝送制御プロトコル (TCP) ソケットにこのプロパティを設定しても無効です。

使用例

DontFragment プロパティの使用方法を示すコード例を次に示します。

static void ConfigureUdpSocket(Socket udpSocket)
{
    // set the Don't Fragment flag.
    udpSocket.DontFragment = true;
    // Enable broadcast.
    udpSocket.EnableBroadcast = true;

    // Disable multicast loopback.
    udpSocket.MulticastLoopback = false;

    Console.WriteLine("Udp Socket configured:");
    Console.WriteLine("  DontFragment {0}", 
                                        udpSocket.DontFragment);
    Console.WriteLine("  EnableBroadcast {0}", 
                                        udpSocket.EnableBroadcast);
    Console.WriteLine("  MulticastLoopback {0}", 
                                        udpSocket.MulticastLoopback);
}

C++

static void ConfigureUdpSocket(Socket^ udpSocket)
{

    // Set the Don't Fragment flag.
    udpSocket->DontFragment = true;
     
    // Enable broadcast.
    udpSocket->EnableBroadcast = true;
     
    // Disable multicast loopback.
    udpSocket->MulticastLoopback = false;
    Console::WriteLine("Udp Socket configured:");
    Console::WriteLine("  DontFragment {0}", 
        udpSocket->DontFragment);
    Console::WriteLine("  EnableBroadcast {0}", 
        udpSocket->EnableBroadcast);
    Console::WriteLine("  MulticastLoopback {0}", 
        udpSocket->MulticastLoopback);
}