TcpListener.Start Méthode

  • Référence

Définition

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

Démarre l'écoute de demandes de connexion entrante.

Surcharges

Start()

Démarre l'écoute de demandes de connexion entrante.
Start(Int32)

Lance l'écoute des demandes de connexion entrantes avec un nombre maximal de connexions en attente.

Start()

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

Démarre l'écoute de demandes de connexion entrante.

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

Exceptions

SocketException

Utilisez la propriété ErrorCode pour obtenir le code d'erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation sur les codes 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 est utilisé pour écouter les tentatives de connexion client entrantes.

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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 méthode met en Start file d’attente la demande et continue d’écouter les demandes supplémentaires jusqu’à ce que vous appeliez la Stop méthode. Si TcpListener reçoit une demande de connexion après avoir déjà mis en file d’attente le nombre maximal de connexions, il 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 que vous pouvez utiliser pour envoyer et recevoir des données. La AcceptSocket méthode retourne un Socket que vous pouvez utiliser pour faire de même. 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.

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.

Voir aussi

S’applique à

Start(Int32)

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

Lance l'écoute des 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

SocketException

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

ArgumentOutOfRangeException

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

InvalidOperationException

Le Socket sous-jacent est null.

Exemples

L’exemple de code suivant montre comment Start est utilisé pour écouter les tentatives de connexion client entrantes.

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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 en file d’attente la demande et continue d’écouter les demandes supplémentaires jusqu’à ce que vous appeliez la Stop méthode. Si TcpListener reçoit une demande de connexion après avoir déjà mis en file d’attente le nombre maximal de connexions, il 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 que vous pouvez utiliser pour envoyer et recevoir des données. La AcceptSocket méthode retourne un Socket que vous pouvez utiliser pour faire de même. Si votre application nécessite uniquement des E/S synchrones, utilisez .AcceptTcpClient Pour un contrôle comportemental plus détaillé, utilisez la AcceptSocket 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.

Notes

Utilisez la propriété SocketException.ErrorCode pour obtenir le code d’erreur, et reportez-vous à la documentation sur les codes d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

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.

Voir aussi

S’applique à