UdpClient.ExclusiveAddressUse Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origem:

UDPClient.cs

Obtém ou define um valor Boolean que especifica se o UdpClient permite que um único cliente use uma porta.

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

public bool ExclusiveAddressUse { get; set; }

member this.ExclusiveAddressUse : bool with get, set

Public Property ExclusiveAddressUse As Boolean

Valor da propriedade

Boolean

true se o UdpClient permitir que apenas um cliente use uma porta específica; caso contrário, false. O padrão é true para o Windows Server 2003 e Windows XP Service Pack 2 e posterior e false para todas as outras versões.

Exceções

SocketException

Erro ao tentar acessar o soquete subjacente.

ObjectDisposedException

O Socket subjacente foi fechado.

Exemplos

O exemplo de código a seguir cria um UdpCliente obtém e define a ExclusiveAddressUse propriedade .

static void GetSetExclusiveAddressUse( UdpClient^ u )
{
   // Don't allow another client to bind to this port.
   u->ExclusiveAddressUse = true;
   Console::WriteLine(  "ExclusiveAddressUse value is {0}", u->ExclusiveAddressUse );
}

public static void GetSetExclusiveAddressUse(UdpClient u)
{
    // Don't allow another client to bind to this port.
    u.ExclusiveAddressUse = true;
    Console.WriteLine("ExclusiveAddressUse value is {0}",
        u.ExclusiveAddressUse);
}

Comentários

Por padrão, vários clientes podem usar uma porta específica; no entanto, apenas um dos clientes pode executar operações no tráfego de rede enviado para a porta. Você pode usar a ExclusiveAddressUse propriedade para impedir que vários clientes usem uma porta específica.

Essa propriedade deve ser definida antes que o soquete subjacente seja associado a uma porta do cliente. Se você chamar UdpClient.UdpClient(Int32), UdpClient.UdpClient(Int32, AddressFamily), UdpClient.UdpClient(IPEndPoint)ou UdpClient.UdpClient(String, Int32), a porta do cliente será associada como um efeito colateral do construtor e você não poderá definir posteriormente a ExclusiveAddressUse propriedade