Socket.Listen Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Sobrecargas

Listen()	Coloca un objeto Socket en un estado de escucha.
Listen(Int32)	Coloca un objeto Socket en un estado de escucha.

Listen()

Source:

Socket.cs

Coloca un objeto Socket en un estado de escucha.

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

Comentarios

La longitud máxima de la cola de conexiones pendientes se determina automáticamente.

Listen(Int32)

Source:

Socket.cs

Coloca un objeto Socket en un estado de escucha.

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

Parámetros

backlog

Int32

Longitud máxima de la cola de conexiones pendientes.

Excepciones

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

Ejemplos

En el ejemplo de código siguiente se usa Socket para escuchar las conexiones entrantes.

// create the socket
Socket^ listenSocket = gcnew Socket( AddressFamily::InterNetwork,
   SocketType::Stream,
   ProtocolType::Tcp );

// bind the listening socket to the port
IPAddress^ hostIP = ( Dns::Resolve( IPAddress::Any->ToString() ) )->AddressList[ 0 ];
IPEndPoint^ ep = gcnew IPEndPoint( hostIP,port );
listenSocket->Bind( ep );

// start listening
listenSocket->Listen( backlog );

    // create the socket
    Socket listenSocket = new Socket(AddressFamily.InterNetwork,
                                     SocketType.Stream,
                                     ProtocolType.Tcp);

    // bind the listening socket to the port
IPAddress hostIP = (Dns.Resolve(IPAddress.Any.ToString())).AddressList[0];
    IPEndPoint ep = new IPEndPoint(hostIP, port);
    listenSocket.Bind(ep);

    // start listening
    listenSocket.Listen(backlog);

   ' create the socket
   Dim listenSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   
   ' bind the listening socket to the port
   Dim hostIP As IPAddress = Dns.Resolve(IPAddress.Any.ToString()).AddressList(0)
   Dim ep As New IPEndPoint(hostIP, port)
   listenSocket.Bind(ep)
   
   ' start listening
   listenSocket.Listen(backlog)
End Sub

Comentarios

Listen hace que un orientado Socket a la conexión escuche los intentos de conexión entrantes. El backlog parámetro especifica el número de conexiones entrantes que se pueden poner en cola para su aceptación. Para determinar el número máximo de conexiones que puede especificar, recupere el MaxConnections valor. Listen no bloquea.

Si recibe un SocketException, use la ErrorCode propiedad para obtener el código de error específico. Después de obtener este código, 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. Use Accept o BeginAccept para aceptar una conexión de la cola.

Nota

Debe llamar al Bind método antes de llamar a Listen, o Listen iniciará una SocketExceptionexcepción .

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, consulte Seguimiento de red en .NET Framework.

Nota

El parámetro backlog se limita a valores diferentes en función del sistema operativo. Puede especificar un valor mayor, pero el trabajo pendiente se limitará en función del sistema operativo.

Consulte también

• MaxConnections
• Accept()
• Bind(EndPoint)