UdpClient.ExclusiveAddressUse Propriedade

Definição

Namespace:

System.Net.Sockets

Assemblies:

netstandard.dll, System.Net.Sockets.dll

Origem:

UDPClient.cs

Obtém ou define um Boolean valor que especifica se o UdpClient cliente permite que apenas um 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 cliente permitir que apenas um cliente use uma porta específica; caso contrário, false. O padrão é true para 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 subjacente Socket foi fechado.

Exemplos

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

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 esteja associado a uma porta do cliente. Se você chamar UdpClient.UdpClient(Int32), UdpClient.UdpClient(Int32, AddressFamily), ou UdpClient.UdpClient(IPEndPoint)UdpClient.UdpClient(String, Int32), a porta do cliente é associada como um efeito colateral do construtor e você não pode definir posteriormente a ExclusiveAddressUse propriedade