TcpListener.AcceptSocketAsync Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Sobrecargas

AcceptSocketAsync()	Acepta una solicitud de conexión pendiente como una operación asincrónica.
AcceptSocketAsync(CancellationToken)	Acepta una solicitud de conexión pendiente como una operación asincrónica cancelable.

AcceptSocketAsync()

Source:

TCPListener.cs

Acepta una solicitud de conexión pendiente como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptSocketAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptSocketAsync ();

member this.AcceptSocketAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync () As Task(Of Socket)

Devoluciones

Task<Socket>

Objeto de tarea que representa la operación asincrónica. La propiedad Result en el objeto de tarea devuelve Socket utilizado para enviar y recibir datos.

Excepciones

InvalidOperationException

El agente de escucha no se ha iniciado con una llamada a Start().

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará una vez aceptada la conexión de socket.

El Socket devuelto en Task<TResult> se inicializa con la dirección IP y el número de puerto del host remoto. Puede usar cualquiera de los Send métodos y Receive disponibles en la Socket clase para comunicarse con el host remoto. Cuando haya terminado de usar Socket, asegúrese de llamar a su Close método . Si la aplicación es relativamente sencilla, considere la posibilidad de usar el AcceptTcpClient método en lugar del AcceptSocketAsync método . TcpClient proporciona métodos sencillos para enviar y recibir datos a través de una red en modo sincrónico de bloqueo.

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por AcceptSocket().

Consulte también

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(CancellationToken)

Source:

TCPListener.cs

Acepta una solicitud de conexión pendiente como una operación asincrónica cancelable.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptSocketAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptSocketAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptSocketAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

Parámetros

cancellationToken

CancellationToken

Token de cancelación que se puede usar para cancelar la operación asincrónica.

Devoluciones

ValueTask<Socket>

Objeto de tarea que representa la operación asincrónica. La propiedad Result en el objeto de tarea devuelve Socket utilizado para enviar y recibir datos.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará una vez aceptada la conexión de socket.

El Socket devuelto en Task<TResult> se inicializa con la dirección IP y el número de puerto del host remoto. Puede usar cualquiera de los Send métodos y Receive disponibles en la Socket clase para comunicarse con el host remoto. Cuando haya terminado de usar Socket, asegúrese de llamar a su Close método . Si la aplicación es relativamente sencilla, considere la posibilidad de usar el AcceptTcpClient método en lugar del AcceptSocketAsync método . TcpClient proporciona métodos sencillos para enviar y recibir datos a través de una red en modo sincrónico de bloqueo.

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por AcceptSocket().