TcpClient.ExclusiveAddressUse Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origem:

TCPClient.cs

Obtém ou define um valor Boolean que especifica se o TcpClient 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 TcpClient 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 ExclusiveAddressUse seguir cria um TcpClient e obtém e define o valor da propriedade .

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

static void GetSetExclusiveAddressUse()
{
    // Don't allow another process to bind to this port.
    t.ExclusiveAddressUse = true;
    Console.WriteLine("ExclusiveAddressUse value is {0}",
        t.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 Connect, BeginConnect, TcpClient(IPEndPoint)ou TcpClient(String, Int32), a porta do cliente será associada como um efeito colateral do método e você não poderá definir a ExclusiveAddressUse propriedade posteriormente.