Compartir a través de

TcpListener.Start Método

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblados:
netstandard.dll, System.Net.Sockets.dll
Ensamblado:
System.Net.Sockets.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Comienza a escuchar las solicitudes de conexión entrantes.

Sobrecargas

Nombre Description
Start()

Comienza a escuchar las solicitudes de conexión entrantes.
Start(Int32)

Comienza a escuchar las solicitudes de conexión entrantes con un número máximo de conexiones pendientes.

Start()

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

Comienza a escuchar las solicitudes de conexión entrantes.

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

Excepciones

SocketException

Use la ErrorCode propiedad para obtener el código de error específico. Cuando haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener 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 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 Start método 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, iniciará un SocketException elemento 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 que puede usar para hacer lo mismo. Si la aplicación solo requiere E/S sincrónica, use AcceptTcpClient. Para obtener un control de comportamiento más detallado, use AcceptSocket. Ambos métodos 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 al habilitar 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
Source:
TCPListener.cs
Source:
TCPListener.cs

Comienza a escuchar las solicitudes de conexión entrantes con un número máximo de conexiones pendientes.

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

SocketException

Error al acceder al socket.

ArgumentOutOfRangeException

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

InvalidOperationException

El valor subyacente Socket es NULL.

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 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, iniciará un SocketException elemento 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 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 el AcceptSocket método . Ambos métodos 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 SocketException.ErrorCode propiedad para obtener el código de error específico y consulte la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota:

Este miembro genera información de seguimiento al habilitar 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