Socket.Listen Méthode

  • Référence

Définition

Espace de noms:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assemblys:
System.dll, System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Surcharges

Listen()

Met Socket dans un état d'écoute.
Listen(Int32)

Met Socket dans un état d'écoute.

Listen()

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

Met Socket dans un état d'écoute.

public:
 void Listen();
public void Listen ();
member this.Listen : unit -> unit
Public Sub Listen ()

Remarques

La longueur maximale de la file d’attente des connexions en attente est déterminée automatiquement.

S’applique à

Listen(Int32)

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

Met Socket dans un état d'écoute.

public:
 void Listen(int backlog);
public void Listen (int backlog);
member this.Listen : int -> unit
Public Sub Listen (backlog As Integer)

Paramètres

backlog
Int32

Longueur maximale de la file d'attente des connexions en attente.

Exceptions

SocketException

Une erreur s’est produite pendant la tentative d’accès au socket.

ObjectDisposedException

Socket a été fermé.

Exemples

L’exemple de code suivant utilise Socket pour écouter les connexions entrantes.

// create the socket
Socket^ listenSocket = gcnew Socket( AddressFamily::InterNetwork,
   SocketType::Stream,
   ProtocolType::Tcp );

// bind the listening socket to the port
IPAddress^ hostIP = ( Dns::Resolve( IPAddress::Any->ToString() ) )->AddressList[ 0 ];
IPEndPoint^ ep = gcnew IPEndPoint( hostIP,port );
listenSocket->Bind( ep );

// start listening
listenSocket->Listen( backlog );

    // create the socket
    Socket listenSocket = new Socket(AddressFamily.InterNetwork,
                                     SocketType.Stream,
                                     ProtocolType.Tcp);

    // bind the listening socket to the port
IPAddress hostIP = (Dns.Resolve(IPAddress.Any.ToString())).AddressList[0];
    IPEndPoint ep = new IPEndPoint(hostIP, port);
    listenSocket.Bind(ep);

    // start listening
    listenSocket.Listen(backlog);

   ' create the socket
   Dim listenSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   
   ' bind the listening socket to the port
   Dim hostIP As IPAddress = Dns.Resolve(IPAddress.Any.ToString()).AddressList(0)
   Dim ep As New IPEndPoint(hostIP, port)
   listenSocket.Bind(ep)
   
   ' start listening
   listenSocket.Listen(backlog)
End Sub

Remarques

Listen permet à un utilisateur orienté Socket connexion d’écouter les tentatives de connexion entrantes. Le backlog paramètre spécifie le nombre de connexions entrantes qui peuvent être mises en file d’attente pour acceptation. Pour déterminer le nombre maximal de connexions que vous pouvez spécifier, récupérez la MaxConnections valeur. Listen ne bloque pas.

Si vous recevez un SocketException, utilisez la ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur. Utilisez Accept ou BeginAccept pour accepter une connexion à partir de la file d’attente.

Notes

Vous devez appeler la Bind méthode avant d’appeler Listen, ou Listen lever un SocketException.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Notes

Le paramètre backlog est limité à différentes valeurs en fonction du système d’exploitation. Vous pouvez spécifier une valeur supérieure, mais le backlog sera limité en fonction du système d’exploitation.

Voir aussi

S’applique à