TcpListener.ExclusiveAddressUse Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origem:

TCPListener.cs

Obtém ou define um valor Boolean que especifica se o TcpListener permite que apenas um soquete subjacente escute uma porta específica.

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 TcpListener permitir apenas um TcpListener para escutar 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

InvalidOperationException

O TcpListener foi iniciado. Chame o método Stop() e defina a propriedade ExclusiveAddressUse.

SocketException

Erro ao tentar acessar o soquete subjacente.

ObjectDisposedException

O Socket subjacente foi fechado.

Exemplos

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

public:
    static void GetSetExclusiveAddressUse(TcpListener^ listener)
    {
        // Set Exclusive Address Use for the underlying socket.
        listener->ExclusiveAddressUse = true;
        Console::WriteLine("ExclusiveAddressUse value is {0}",
            listener->ExclusiveAddressUse);
    }

public static void GetSetExclusiveAddressUse(TcpListener t)
{
    // Set Exclusive Address Use for the underlying socket.
    t.ExclusiveAddressUse = true;
    Console.WriteLine("ExclusiveAddressUse value is {0}",
        t.ExclusiveAddressUse);
}

Public Shared Sub GetSetExclusiveAddressUse(t As TcpListener)
   ' Set Exclusive Address Use for the underlying socket.
   t.ExclusiveAddressUse = True
   Console.WriteLine("ExclusiveAddressUse value is {0}", t.ExclusiveAddressUse)
End Sub

Comentários

Por padrão, vários ouvintes podem ouvir uma porta específica. No entanto, apenas um dos ouvintes pode executar operações no tráfego de rede enviado para a porta. Se mais de um ouvinte tentar associar a uma porta específica, aquele com o endereço IP mais específico manipulará o tráfego de rede enviado para essa porta. Você pode usar a ExclusiveAddressUse propriedade para impedir que vários ouvintes ouçam uma porta específica.

Defina essa propriedade antes de chamar Startou chame o Stop método e defina essa propriedade.