TcpListener.Start Méthode

Définition

Commence à écouter les demandes de connexion entrantes.

Surcharges

Nom Description
Start()

Commence à écouter les demandes de connexion entrantes.

Start(Int32)

Commence à écouter les demandes de connexion entrantes avec un nombre maximal de connexions en attente.

Start()

Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs

Commence à écouter les demandes de connexion entrantes.

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

Exceptions

Utilisez la ErrorCode propriété pour obtenir le code d’erreur spécifique. Lorsque vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Exemples

L’exemple de code suivant montre comment Start être utilisé pour écouter les tentatives de connexion client entrante.

public static void DoStart(TcpListener t, int backlog)
{
    // Start listening for client connections with the
    // specified backlog.
    t.Start(backlog);
    Console.WriteLine("started listening");
}
Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
   ' Start listening for client connections with the 
   ' specified backlog.
   t.Start(backlog)
   Console.WriteLine("started listening")
End Sub

Remarques

La Start méthode initialise le sous-jacent Socket, le lie à un point de terminaison local et écoute les tentatives de connexion entrantes. Si une demande de connexion est reçue, la Start méthode met en file d’attente la demande et continue d’écouter des demandes supplémentaires jusqu’à ce que vous appeliez la Stop méthode. Si TcpListener elle reçoit une demande de connexion après avoir déjà mis en file d’attente le nombre maximal de connexions, elle lève un SocketException sur le client.

Pour supprimer une connexion de la file d’attente de connexion entrante, utilisez la AcceptTcpClient méthode ou la AcceptSocket méthode. La AcceptTcpClient méthode supprime une connexion de la file d’attente et retourne un TcpClient élément que vous pouvez utiliser pour envoyer et recevoir des données. La AcceptSocket méthode retourne une Socket méthode que vous pouvez utiliser pour effectuer la même opération. Si votre application nécessite uniquement des E/S synchrones, utilisez AcceptTcpClient. Pour un contrôle comportemental plus détaillé, utilisez AcceptSocket. Ces deux méthodes bloquent jusqu’à ce qu’une demande de connexion soit disponible dans la file d’attente.

Utilisez la Stop méthode pour fermer et arrêter l’écoute TcpListener . Vous êtes responsable de la fermeture de vos connexions acceptées séparément.

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.

Voir aussi

S’applique à

Start(Int32)

Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs

Commence à écouter les demandes de connexion entrantes avec un nombre maximal de connexions en attente.

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

Paramètres

backlog
Int32

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

Exceptions

Une erreur s’est produite lors de l’accès au socket.

Le backlog paramètre est inférieur à zéro ou dépasse le nombre maximal de connexions autorisées.

La valeur sous-jacente Socket est Null.

Exemples

L’exemple de code suivant montre comment Start être utilisé pour écouter les tentatives de connexion client entrante.

public static void DoStart(TcpListener t, int backlog)
{
    // Start listening for client connections with the
    // specified backlog.
    t.Start(backlog);
    Console.WriteLine("started listening");
}
Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
   ' Start listening for client connections with the 
   ' specified backlog.
   t.Start(backlog)
   Console.WriteLine("started listening")
End Sub

Remarques

La Start méthode initialise le sous-jacent Socket, le lie à un point de terminaison local et écoute les tentatives de connexion entrantes. Si une demande de connexion est reçue, Start met la demande en file d’attente et continue à écouter des demandes supplémentaires jusqu’à ce que vous appeliez la Stop méthode. Si TcpListener elle reçoit une demande de connexion une fois qu’elle a déjà mis en file d’attente le nombre maximal de connexions, elle lève un SocketException sur le client.

Pour supprimer une connexion de la file d’attente de connexion entrante, utilisez la AcceptTcpClient méthode ou la AcceptSocket méthode. La AcceptTcpClient méthode supprime une connexion de la file d’attente et retourne un TcpClient élément que vous pouvez utiliser pour envoyer et recevoir des données. La AcceptSocket méthode retourne une Socket méthode que vous pouvez utiliser pour effectuer la même opération. Si votre application nécessite uniquement des E/S synchrones, utilisez le AcceptTcpClientfichier . Pour un contrôle comportemental plus détaillé, utilisez AcceptSocket la méthode. Ces deux méthodes bloquent jusqu’à ce qu’une demande de connexion soit disponible dans la file d’attente.

Utilisez la Stop méthode pour fermer et arrêter l’écoute TcpListener . Vous êtes responsable de la fermeture de vos connexions acceptées séparément.

Note

Utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique et 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.

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.

Voir aussi

S’applique à