Socket.EnableBroadcast Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtém ou define um Boolean valor que especifica se os Socket pacotes de transmissão podem ser enviados.

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

Valor da propriedade

Boolean

true se permitir o Socket envio de pacotes de transmissão; caso contrário, false. O padrão é false.

Exceções

SocketException

Essa opção é válida apenas para um soquete de datagrama.

ObjectDisposedException

O Socket foi fechado.

Exemplos

O exemplo de código a seguir demonstra o uso da EnableBroadcast propriedade.

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

Comentários

A transmissão é limitada a uma sub-rede específica e deve usar o UDP (User Datagram Protocol). Para o Protocolo de Internet versão 4, você pode transmitir para sua sub-rede local enviando um pacote para 255.255.255.255; ou você pode usar o endereço de difusão direcionado, que é a parte de rede de um endereço IP (Protocolo ip) com todos os bits definidos na parte do host. Por exemplo, se o endereço IP for 192.168.1.40 (um endereço classe C, com uma máscara líquida de 255.255.255.0-- a parte da rede é os três primeiros octetos e a parte do host é o último octeto), o endereço de transmissão direcionado é 192.168.1.255.

A configuração dessa propriedade em um soquete TCP (Protocolo de Controle de Transmissão) não terá efeito.