TcpClient.ExclusiveAddressUse Właściwość

Definicja

Pobiera lub ustawia wartość określającą Boolean , czy TcpClient zezwala tylko jednemu klientowi na używanie portu.Gets or sets a Boolean value that specifies whether the TcpClient allows only one client to use a port.

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 TcpClient zezwala tylko jednemu klientowi na użycie określonego portu; w przeciwnym razie, false .true if the TcpClient allows only one client to use a specific port; otherwise, false. Wartość domyślna to true Windows Server 2003 i Windows XP z dodatkiem Service Pack 2 lub nowszym oraz false dla wszystkich innych wersji.The default is true for Windows Server 2003 and Windows XP Service Pack 2 and later, and false for all other versions.

Wyjątki

Wystąpił błąd podczas próby uzyskania dostępu do podstawowego gniazda.An error occurred when attempting to access the underlying socket.

Bazowy Socket został zamknięty.The underlying Socket has been closed.

Przykłady

Poniższy przykład kodu tworzy TcpClient i pobiera i ustawia wartość ExclusiveAddressUse właściwości.The following code example creates a TcpClient and gets and sets the value of the ExclusiveAddressUse property.

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);
}

Uwagi

Domyślnie wielu klientów może używać określonego portu; jednak tylko jeden z klientów może wykonywać operacje związane z ruchem sieciowym wysyłanym do portu.By default, multiple clients can use a specific port; however, only one of the clients can perform operations on the network traffic sent to the port. Możesz użyć właściwości, ExclusiveAddressUse Aby uniemożliwić wielu klientom korzystanie z określonego portu.You can use the ExclusiveAddressUse property to prevent multiple clients from using a specific port.

Ta właściwość musi być ustawiona przed powiązaniem bazowego gniazda z portem klienta.This property must be set before the underlying socket is bound to a client port. Jeśli wywołasz Connect , BeginConnect , TcpClient(IPEndPoint) , lub TcpClient(String, Int32) , Port klienta jest powiązany jako efekt uboczny metody, a następnie nie można ustawić ExclusiveAddressUse właściwości.If you call Connect, BeginConnect, TcpClient(IPEndPoint), or TcpClient(String, Int32), the client port is bound as a side effect of the method, and you cannot subsequently set the ExclusiveAddressUse property.

Dotyczy