TcpListener.ExclusiveAddressUse Propriété

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Source:

TCPListener.cs

Obtient ou définit une valeur Boolean qui spécifie si TcpListener n'autorise qu'un seul socket sous-jacent à écouter un port spécifique.

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

Valeur de propriété

Boolean

true si TcpListener n'autorise qu'un seul TcpListener à écouter un port spécifique ; sinon, false. La valeur par défaut est true pour Windows Server 2003 et Windows XP Service Pack 2 et ultérieur, et false pour toutes les autres versions.

Exceptions

InvalidOperationException

TcpListener a démarré. Appelez la méthode Stop(), puis définissez la propriété ExclusiveAddressUse.

SocketException

Une erreur s'est produite lors de la tentative d'accès au socket sous-jacent.

ObjectDisposedException

Le Socket sous-jacent a été fermé.

Exemples

L’exemple de code suivant obtient et définit la ExclusiveAddressUse propriété .

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

Remarques

Par défaut, plusieurs écouteurs peuvent écouter un port spécifique. Toutefois, un seul des écouteurs peut effectuer des opérations sur le trafic réseau envoyé au port. Si plusieurs écouteurs tentent de se lier à un port particulier, celui qui a l’adresse IP la plus spécifique gère le trafic réseau envoyé à ce port. Vous pouvez utiliser la ExclusiveAddressUse propriété pour empêcher plusieurs écouteurs d’écouter un port spécifique.

Définissez cette propriété avant d’appeler Start, ou appelez la Stop méthode, puis définissez cette propriété.