Socket.EnableBroadcast プロパティ

.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

C#

public bool EnableBroadcast { get;
 set; }

C++

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

J#

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

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 名前空間