Socket.Accept Socket.Accept Socket.Accept Socket.Accept Method

Definición

Crea un nuevo objeto Socket para una conexión recién establecida.Creates a new Socket for a newly created connection.

public:
 System::Net::Sockets::Socket ^ Accept();
public System.Net.Sockets.Socket Accept ();
member this.Accept : unit -> System.Net.Sockets.Socket
Public Function Accept () As Socket

Devoluciones

Objeto Socket para una conexión recién establecida.A Socket for a newly created connection.

Excepciones

Error al intentar acceder al socket.An error occurred when attempting to access the socket.

El socket receptor no realiza escuchas de conexiones.The accepting socket is not listening for connections. Debe llamar a Bind(EndPoint) y a Listen(Int32) antes de llamar a Accept().You must call Bind(EndPoint) and Listen(Int32) before calling Accept().

Ejemplos

En el ejemplo de código siguiente se Socket acepta una conexión simple.The following code example accepts a simple Socket connection.

protected:
   void AcceptMethod( Socket^ listeningSocket )
   {
      Socket^ mySocket = listeningSocket->Accept();
   }
protected void AcceptMethod(Socket listeningSocket)
{
    Socket mySocket = listeningSocket.Accept();
}
   Protected Sub AcceptMethod(listeningSocket As Socket)
       

Dim mySocket As Socket = listeningSocket.Accept()
       
   End Sub

Comentarios

AcceptExtrae sincrónicamente la primera solicitud de conexión pendiente de la cola de solicitudes de conexión del socket de escucha y, Socketa continuación, crea y devuelve un nuevo.Accept synchronously extracts the first pending connection request from the connection request queue of the listening socket, and then creates and returns a new Socket. No puede usar este devuelto Socket para aceptar conexiones adicionales de la cola de conexión.You cannot use this returned Socket to accept any additional connections from the connection queue. Sin embargo, puede llamar RemoteEndPoint al método del devuelto Socket para identificar la dirección de red y el número de puerto del host remoto.However, you can call the RemoteEndPoint method of the returned Socket to identify the remote host's network address and port number.

En modo de bloqueo Accept , se bloquea hasta que se pone en cola un intento de conexión entrante.In blocking mode, Accept blocks until an incoming connection attempt is queued. Una vez aceptada una conexión, la Socket original continúa poniendo en cola las solicitudes de conexión entrantes hasta que se cierra.Once a connection is accepted, the original Socket continues queuing incoming connection requests until you close it.

Si se llama a este método mediante un no bloqueo Sockety no hay ninguna solicitud de conexión en cola Accept , se produce SocketExceptionuna excepción.If you call this method using a non-blocking Socket, and no connection requests are queued, Accept throws a SocketException. Si recibe un SocketException, utilice la SocketException.ErrorCode propiedad para obtener el código de error específico.If you receive a SocketException, use the SocketException.ErrorCode property to obtain the specific error code. 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.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Nota

Antes de llamar Accept al método, debe Listen llamar primero al método para escuchar y poner en cola las solicitudes de conexión entrantes.Before calling the Accept method, you must first call the Listen method to listen for and queue incoming connection requests.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación.This member outputs trace information when you enable network tracing in your application. Para obtener más información, consulte seguimiento de red en el .NET Framework.For more information, see Network Tracing in the .NET Framework.

Se aplica a

Consulte también: