Partager via

Socket.Listen Méthode

Définition

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

Surcharges

Nom Description
Listen()

Place un Socket état d’écoute dans un état d’écoute.
Listen(Int32)

Place un Socket état d’écoute dans un état d’écoute.

Listen()

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

Place un Socket état d’écoute 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
Source:
Socket.cs
Source:
Socket.cs

Place un Socket état d’écoute 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 lors de la tentative d’accès au socket.

ObjectDisposedException

Il Socket a été fermé.

Exemples

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

    // 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 provoque l’écoute d’une connexion Socket pour 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 que vous avez obtenu ce code, 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 acceptez une connexion à partir de la file d’attente.

Note

Vous devez appeler la méthode avant d’appeler BindListen, ou Listen lève un SocketException.

Note

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

Note

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

Voir aussi

S’applique à