Socket.DontFragment プロパティ

.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

C#

public bool DontFragment { get;
 set; }

C++

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

J#

/** @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 プロパティの使用方法を示すコード例を次に示します。

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

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