TcpClient.ExclusiveAddressUse Proprietà

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origine:

TCPClient.cs

Ottiene o imposta un valore Boolean che specifica se la classe TcpClient consente a un unico client di utilizzare una 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

Valore della proprietà

Boolean

true se la classe TcpClient consente a un solo client di utilizzare una porta specifica; in caso contrario false. Il valore predefinito è true per Windows Server 2003 e Windows XP Service Pack 2 e versioni successive e false per tutte le altre versioni.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket sottostante.

ObjectDisposedException

Oggetto Socket sottostante è stato chiuso.

Esempio

L'esempio di codice seguente crea un oggetto TcpClient e ottiene e imposta il valore della ExclusiveAddressUse proprietà .

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

Commenti

Per impostazione predefinita, più client possono usare una porta specifica; Tuttavia, solo uno dei client può eseguire operazioni sul traffico di rete inviato alla porta. È possibile usare la ExclusiveAddressUse proprietà per impedire a più client di usare una porta specifica.

Questa proprietà deve essere impostata prima che il socket sottostante sia associato a una porta client. Se si chiama Connect, BeginConnectTcpClient(IPEndPoint), o TcpClient(String, Int32), la porta client viene associata come effetto collaterale del metodo e non è possibile impostare successivamente la ExclusiveAddressUse proprietà .