Compartir a través de


TcpListener.Start Método

Definición

Comienza la escucha de solicitudes de conexión entrantes.

Sobrecargas

Start()

Comienza la escucha de solicitudes de conexión entrantes.

Start(Int32)

Comienza la escucha de solicitudes de conexión entrantes en un número máximo de conexión pendiente.

Start()

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

Comienza la escucha de solicitudes de conexión entrantes.

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

Excepciones

Utilice la propiedad ErrorCode para obtener el código de error específico. Cuando obtenga este código, puede ver la documentación de códigos de error de la API de Windows Sockets, versión 2, para ver una descripción detallada del error.

Ejemplos

En el ejemplo de código siguiente se muestra cómo Start se usa para escuchar los intentos de conexión de cliente 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

Comentarios

El Start método inicializa el subyacente Socket, lo enlaza a un punto de conexión local y escucha los intentos de conexión entrantes. Si se recibe una solicitud de conexión, el método pondrá en Start cola la solicitud y seguirá escuchando solicitudes adicionales hasta que llame al Stop método . Si TcpListener recibe una solicitud de conexión después de que ya haya puesto en cola el número máximo de conexiones, iniciará un SocketException en el cliente.

Para quitar una conexión de la cola de conexión entrante, use el AcceptTcpClient método o el AcceptSocket método . El AcceptTcpClient método quitará una conexión de la cola y devolverá un TcpClient que puede usar para enviar y recibir datos. El AcceptSocket método devolverá un Socket objeto que puede usar para hacer lo mismo. Si la aplicación solo requiere E/S sincrónica, use AcceptTcpClient. Para un control de comportamiento más detallado, use AcceptSocket. Ambos métodos se bloquean hasta que una solicitud de conexión está disponible en la cola.

Use el Stop método para cerrar y detener la TcpListener escucha. Usted es responsable de cerrar las conexiones aceptadas por separado.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Consulte también

Se aplica a

Start(Int32)

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

Comienza la escucha de solicitudes de conexión entrantes en un número máximo de conexión pendiente.

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

Parámetros

backlog
Int32

Longitud máxima de la cola de conexiones pendientes.

Excepciones

Se ha producido un error al obtener acceso al socket.

El parámetro backlog es menor que cero o supera el número máximo de conexiones permitidas.

Ejemplos

En el ejemplo de código siguiente se muestra cómo Start se usa para escuchar los intentos de conexión de cliente 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

Comentarios

El Start método inicializa el subyacente Socket, lo enlaza a un punto de conexión local y escucha los intentos de conexión entrantes. Si se recibe una solicitud de conexión, Start pondrá en cola la solicitud y seguirá escuchando solicitudes adicionales hasta que llame al Stop método . Si TcpListener recibe una solicitud de conexión después de que ya haya puesto en cola el número máximo de conexiones que iniciará en SocketException el cliente.

Para quitar una conexión de la cola de conexión entrante, use el AcceptTcpClient método o el AcceptSocket método . El AcceptTcpClient método quitará una conexión de la cola y devolverá un TcpClient que puede usar para enviar y recibir datos. El AcceptSocket método devolverá un Socket objeto que puede usar para hacer lo mismo. Si la aplicación solo requiere E/S sincrónica, use .AcceptTcpClient Para un control de comportamiento más detallado, use AcceptSocket el método . Ambos métodos se bloquean hasta que una solicitud de conexión está disponible en la cola.

Use el Stop método para cerrar y detener la TcpListener escucha. Usted es responsable de cerrar las conexiones aceptadas por separado.

Nota

Use la propiedad SocketException.ErrorCode para obtener el código de error concreto y consulte la documentación de códigos de error de la API de Windows Sockets, versión 2, para ver una descripción detallada del error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Consulte también

Se aplica a