TcpListener.ExclusiveAddressUse Właściwość

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Pobiera lub ustawia wartość określającą Boolean , czy TcpListener zezwala tylko jednemu gniazdu bazowemu na nasłuchiwanie określonego portu.

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

Wartość właściwości

Boolean

true jeśli parametr TcpListener zezwala tylko TcpListener jednemu na nasłuchiwanie określonego portu; w przeciwnym razie false. Wartością domyślną jest true Windows Server 2003 i Windows XP z dodatkiem Service Pack 2 lub nowszym oraz false dla wszystkich innych wersji.

Wyjątki

InvalidOperationException

Rozpoczęto TcpListener . Wywołaj metodę Stop() , a następnie ustaw ExclusiveAddressUse właściwość .

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda bazowego.

ObjectDisposedException

Podstawy Socket zostały zamknięte.

Przykłady

Poniższy przykład kodu pobiera i ustawia ExclusiveAddressUse właściwość .

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

Uwagi

Domyślnie wiele odbiorników może nasłuchiwać określonego portu. Jednak tylko jeden z odbiorników może wykonywać operacje na ruchu sieciowym wysyłanym do portu. Jeśli więcej niż jeden odbiornik próbuje powiązać z określonym portem, ten z bardziej określonym adresem IP obsługuje ruch sieciowy wysyłany do tego portu. Można użyć ExclusiveAddressUse właściwości , aby uniemożliwić wielu odbiornikom nasłuchiwanie określonego portu.

Ustaw tę właściwość przed wywołaniem Startmetody lub wywołaj metodę Stop , a następnie ustaw tę właściwość.