TcpListener.Start TcpListener.Start TcpListener.Start TcpListener.Start Method

Définition

Démarre l'écoute de demandes de connexion entrante.Starts listening for incoming connection requests.

Surcharges

Start() Start() Start() Start()

Démarre l'écoute de demandes de connexion entrante.Starts listening for incoming connection requests.

Start(Int32) Start(Int32) Start(Int32) Start(Int32)

Lance l'écoute des demandes de connexion entrantes avec un nombre maximal de connexions en attente.Starts listening for incoming connection requests with a maximum number of pending connection.

Start() Start() Start() Start()

Démarre l'écoute de demandes de connexion entrante.Starts listening for incoming connection requests.

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

Exceptions

Utilisez la propriété ErrorCode pour obtenir le code d'erreur spécifique.Use the ErrorCode property to obtain the specific error code. 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.When you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Exemples

L’exemple de code suivant montre comment Start est utilisé pour écouter les tentatives de connexions clientes entrantes.The following code example demonstrates how Start is used to listen for incoming client connection attempts.

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 'DoStart

Remarques

Le Start méthode initialise sous-jacent Socketlie à un point de terminaison local et écoute les tentatives de connexion entrante.The Start method initializes the underlying Socket, binds it to a local endpoint, and listens for incoming connection attempts. Si une demande de connexion est reçue, le Start méthode file d’attente de la demande et continue à écouter les demandes supplémentaires jusqu'à ce que vous appeliez la Stop (méthode).If a connection request is received, the Start method will queue the request and continue listening for additional requests until you call the Stop method. Si TcpListener reçoit une demande de connexion une fois qu’il a déjà en file d’attente le nombre maximal de connexions, il lève une SocketException sur le client.If TcpListener receives a connection request after it has already queued the maximum number of connections, it will throw a SocketException on the client.

Pour supprimer une connexion à partir de la file d’attente de connexion entrante, utiliser le AcceptTcpClient méthode ou le AcceptSocket (méthode).To remove a connection from the incoming connection queue, use either the AcceptTcpClient method or the AcceptSocket method. Le AcceptTcpClient méthode supprimer une connexion à partir de la file d’attente et retournera un TcpClient que vous pouvez utiliser pour envoyer et recevoir des données.The AcceptTcpClient method will remove a connection from the queue and return a TcpClient that you can use to send and receive data. Le AcceptSocket méthode retournera un Socket que vous pouvez utiliser pour faire de même.The AcceptSocket method will return a Socket that you can use to do the same. Si votre application requiert uniquement les e/s synchrones, utilisez AcceptTcpClient.If your application only requires synchronous I/O, use AcceptTcpClient. Pour plus de contrôle de comportement, utilisez AcceptSocket.For more detailed behavioral control, use AcceptSocket. Ces deux méthodes bloquent jusqu'à ce qu’une demande de connexion est disponible dans la file d’attente.Both of these methods block until a connection request is available in the queue.

Utilisez le Stop méthode pour fermer le TcpListener et arrêter l’écoute.Use the Stop method to close the TcpListener and stop listening. Vous êtes chargé de fermer vos connexions acceptées séparément.You are responsible for closing your accepted connections separately.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez le traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

Start(Int32) Start(Int32) Start(Int32) Start(Int32)

Lance l'écoute des demandes de connexion entrantes avec un nombre maximal de connexions en attente.Starts listening for incoming connection requests with a maximum number of pending connection.

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 Int32 Int32 Int32

Longueur maximale de la file d'attente des connexions en attente.The maximum length of the pending connections queue.

Exceptions

Une erreur s'est produite lors de l'accès au socket.An error occurred while accessing the socket.

Le paramètre backlog est inférieur à zéro ou dépasse le nombre maximal de connexions autorisées.The backlog parameter is less than zero or exceeds the maximum number of permitted connections.

Exemples

L’exemple de code suivant montre comment Start est utilisé pour écouter les tentatives de connexions clientes entrantes.The following code example demonstrates how Start is used to listen for incoming client connection attempts.

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 'DoStart

Remarques

Le Start méthode initialise sous-jacent Socketlie à un point de terminaison local et écoute les tentatives de connexion entrante.The Start method initializes the underlying Socket, binds it to a local endpoint, and listens for incoming connection attempts. Si une demande de connexion est reçue, Start sera file d’attente de la demande et continue à écouter les demandes supplémentaires jusqu'à ce que vous appeliez la Stop (méthode).If a connection request is received, Start will queue the request and continue listening for additional requests until you call the Stop method. Si TcpListener reçoit une demande de connexion une fois qu’il a déjà en file d’attente le nombre maximal de connexions, il lève une SocketException sur le client.If TcpListener receives a connection request after it has already queued the maximum number of connections it will throw a SocketException on the client.

Pour supprimer une connexion à partir de la file d’attente de connexion entrante, utiliser le AcceptTcpClient méthode ou le AcceptSocket (méthode).To remove a connection from the incoming connection queue, use either the AcceptTcpClient method or the AcceptSocket method. Le AcceptTcpClient méthode supprimer une connexion à partir de la file d’attente et retournera un TcpClient que vous pouvez utiliser pour envoyer et recevoir des données.The AcceptTcpClient method will remove a connection from the queue and return a TcpClient that you can use to send and receive data. Le AcceptSocket méthode retournera un Socket que vous pouvez utiliser pour faire de même.The AcceptSocket method will return a Socket that you can use to do the same. Si votre application requiert uniquement les e/s synchrones, utilisez le AcceptTcpClient.If your application only requires synchronous I/O, use the AcceptTcpClient. Pour plus de contrôle de comportement, utilisez AcceptSocket (méthode).For more detailed behavioral control, use AcceptSocket method. Ces deux méthodes bloquent jusqu'à ce qu’une demande de connexion est disponible dans la file d’attente.Both of these methods block until a connection request is available in the queue.

Utilisez le Stop méthode pour fermer le TcpListener et arrêter l’écoute.Use the Stop method to close the TcpListener and stop listening. Vous êtes chargé de fermer vos connexions acceptées séparément.You are responsible for closing your accepted connections separately.

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.Use the SocketException.ErrorCode property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez le traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

S’applique à