Socket.ExclusiveAddressUse Proprietà

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

netstandard.dll, System.Net.Sockets.dll

Origine:

Socket.cs

Ottiene o imposta un valore che indica se consente a un solo processo di eseguire l'associazione Socket a 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 consente a un solo socket di eseguire l'associazione Socket a una porta specifica; in caso contrario, false. Il valore predefinito è true per Windows Server 2003 e Windows XP e versioni più recenti.

Eccezioni

SocketException

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

ObjectDisposedException

L'oggetto Socket è stato chiuso.

InvalidOperationException

Bind(EndPoint) è stato chiamato per questo Socketoggetto .

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della ExclusiveAddressUse proprietà .

static void ConfigureTcpSocket(Socket tcpSocket)
{
    // Don't allow another socket to bind to this port.
    tcpSocket.ExclusiveAddressUse = true;

    // The socket will linger for 10 seconds after
    // Socket.Close is called.
    tcpSocket.LingerState = new LingerOption (true, 10);

    // Disable the Nagle Algorithm for this tcp socket.
    tcpSocket.NoDelay = true;

    // Set the receive buffer size to 8k
    tcpSocket.ReceiveBufferSize = 8192;

    // Set the timeout for synchronous receive methods to
    // 1 second (1000 milliseconds.)
    tcpSocket.ReceiveTimeout = 1000;

    // Set the send buffer size to 8k.
    tcpSocket.SendBufferSize = 8192;

    // Set the timeout for synchronous send methods
    // to 1 second (1000 milliseconds.)
    tcpSocket.SendTimeout = 1000;

    // Set the Time To Live (TTL) to 42 router hops.
    tcpSocket.Ttl = 42;

    Console.WriteLine("Tcp Socket configured:");

    Console.WriteLine($"  ExclusiveAddressUse {tcpSocket.ExclusiveAddressUse}");

    Console.WriteLine($"  LingerState {tcpSocket.LingerState.Enabled}, {tcpSocket.LingerState.LingerTime}");

    Console.WriteLine($"  NoDelay {tcpSocket.NoDelay}");

    Console.WriteLine($"  ReceiveBufferSize {tcpSocket.ReceiveBufferSize}");

    Console.WriteLine($"  ReceiveTimeout {tcpSocket.ReceiveTimeout}");

    Console.WriteLine($"  SendBufferSize {tcpSocket.SendBufferSize}");

    Console.WriteLine($"  SendTimeout {tcpSocket.SendTimeout}");

    Console.WriteLine($"  Ttl {tcpSocket.Ttl}");

    Console.WriteLine($"  IsBound {tcpSocket.IsBound}");

    Console.WriteLine("");
}

Commenti

Se ExclusiveAddressUse è false, più socket possono usare il metodo per eseguire l'associazione Bind a una porta specifica. Tuttavia, solo uno dei socket può eseguire operazioni sul traffico di rete inviato alla porta. Se più socket tenta di usare il Bind(EndPoint) metodo per l'associazione a una determinata porta, quello con l'indirizzo IP più specifico gestirà il traffico di rete inviato a tale porta.

Se ExclusiveAddressUse è true, il primo utilizzo del Bind metodo per tentare di eseguire l'associazione a una determinata porta, indipendentemente dall'indirizzo IP (Internet Protocol), avrà esito positivo. Tutti gli usi successivi del Bind metodo per tentare di eseguire l'associazione a tale porta avranno esito negativo finché il socket associato originale non verrà eliminato definitivamente.

Questa proprietà deve essere impostata prima Bind della chiamata. In caso contrario, verrà generata un'eccezione InvalidOperationException .