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

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

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

Socket.EnableBroadcast プロパティ

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

Socket でブロードキャストパケットの送受信を許可するかどうかを指定する Boolean 値を取得または設定します。

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

Visual Basic (宣言)

Public Property EnableBroadcast As
 Boolean

Visual Basic (使用法)

Dim instance As Socket
Dim value As Boolean

value = instance.EnableBroadcast

instance.EnableBroadcast = value

public bool EnableBroadcast { get;
 set; }

C++

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

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

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

JScript

public function get EnableBroadcast
 () : boolean

public function set EnableBroadcast
 (value : boolean)

プロパティ値
Socket でブロードキャストパケットを許可する場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
SocketException	このオプションは、データグラムソケットに対してだけ有効です。
ObjectDisposedException	Socket は閉じられています。

解説

ブロードキャストは、特定のサブネットに制限され、また、ユーザーデータグラムプロトコル (UDP) を使用する必要があります。インターネットプロトコル Version 4 では、255.255.255.255 宛てにパケットを送信するか、ダイレクトブロードキャストアドレス (ホスト部分のすべてのビットを 1 に設定したインターネットプロトコル (IP) アドレスのネットワーク部分) を使用してローカルサブネットにブロードキャストできます。たとえば、IP アドレスが 192.168.1.40 (ネットマスクとして 255.255.255.0 を使用するクラス C アドレス。ネットワーク部分は最初の 3 つのオクテットでホスト部分は最後のオクテット) の場合、ダイレクトブロードキャストアドレスは 192.168.1.255 になります。

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

使用例

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

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