Socket.EnableBroadcast Eigenschaft

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Quelle:

Socket.cs

Ruft einen Boolean Wert ab, der angibt, ob sendepakete Socket gesendet werden können, oder legt diesen fest.

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

public bool EnableBroadcast { get; set; }

member this.EnableBroadcast : bool with get, set

Public Property EnableBroadcast As Boolean

Eigenschaftswert

Boolean

true , wenn das das Socket Senden von Broadcastpaketen zulässt, falseandernfalls . Der Standardwert lautet false.

Ausnahmen

SocketException

Diese Option ist nur für Datagrammsockets gültig.

ObjectDisposedException

Der Socket wurde geschlossen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EnableBroadcast-Attributs veranschaulicht.

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

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 {udpSocket.DontFragment}");
    Console.WriteLine($"  EnableBroadcast {udpSocket.EnableBroadcast}");
    Console.WriteLine($"  MulticastLoopback {udpSocket.MulticastLoopback}");
}

Hinweise

Die Übertragung ist auf ein bestimmtes Subnetz beschränkt und muss UDP (User Datagram Protocol) verwenden. Bei Internetprotokollversion 4 können Sie in Ihr lokales Subnetz senden, indem Sie ein Paket an 255.255.255.255 senden. Oder Sie können die gesendete Broadcastadresse verwenden, bei der es sich um den Netzwerkteil einer IP-Adresse (Internet Protocol) handelt, bei der alle Bits im Hostteil festgelegt sind. Wenn Ihre IP-Adresse beispielsweise 192.168.1.40 ist (eine Adresse der Klasse C mit einer Netzmaske von 255.255.255.255.0 - der Netzwerkteil ist die ersten drei Oktette und der Hostteil das letzte Oktett), lautet Ihre gesendete Sendeadresse 192.168.1.255.

Das Festlegen dieser Eigenschaft für einen TCP-Socket (Transmission Control Protocol) hat keine Auswirkungen.