TcpListener.AcceptTcpClientAsync Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Sobrecargas

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

AcceptTcpClientAsync()

Source:

TCPListener.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Sockets::TcpClient ^> ^ AcceptTcpClientAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.TcpClient> AcceptTcpClientAsync ();

member this.AcceptTcpClientAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync () As Task(Of TcpClient)

Devoluciones

Task<TcpClient>

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

Excepciones

InvalidOperationException

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

SocketException

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.

Comentarios

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

Use el TcpClient.GetStream método para obtener el subyacente NetworkStream del devuelto TcpClient en .Task<TResult> NetworkStream Le proporcionará métodos para enviar y recibir con el host remoto. Cuando esté a través de con TcpClient, asegúrese de llamar a su Close método . Si desea una mayor flexibilidad que una TcpClient oferta, considere la posibilidad de usar AcceptSocket o AcceptSocketAsync.

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, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por AcceptTcpClient().

Consulte también

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(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::TcpClient ^> AcceptTcpClientAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient> AcceptTcpClientAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptTcpClientAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync (cancellationToken As CancellationToken) As ValueTask(Of TcpClient)

Parámetros

cancellationToken

CancellationToken

Un token de cancelación que se puede usar para cancelar la operación asincrónica

Devoluciones

ValueTask<TcpClient>

Objeto de tarea que representa la operación asincrónica. La propiedad Result en el objeto de tarea devuelve TcpClient 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 TCP.

Use el TcpClient.GetStream método para obtener el subyacente NetworkStream del devuelto TcpClient en .Task<TResult> NetworkStream Le proporcionará métodos para enviar y recibir con el host remoto. Cuando esté a través de con TcpClient, asegúrese de llamar a su Close método . Si desea una mayor flexibilidad que una TcpClient oferta, considere la posibilidad de usar AcceptSocket o AcceptSocketAsync.

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, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por AcceptTcpClient().