TcpListener.Start Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
El Socket es nulo.
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.