TcpListener.AcceptTcpClientAsync Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Sobrecargas

AcceptTcpClientAsync()	Aceita uma solicitação de conexão pendente como uma operação assíncrona.
AcceptTcpClientAsync(CancellationToken)	Aceita uma solicitação de conexão pendente como uma operação assíncrona cancelável.

AcceptTcpClientAsync()

Origem:

TCPListener.cs

Aceita uma solicitação de conexão pendente como uma operação assíncrona.

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)

Retornos

Task<TcpClient>

O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna um TcpClient usado para enviar e receber dados.

Exceções

InvalidOperationException

O ouvinte não foi iniciado com uma chamada para Start().

SocketException

Use a propriedade ErrorCode para obter o código de erro específico. Quando tiver obtido esse código, você poderá consultar a documentação de códigos de erro da API da versão 2 do Windows Sockets para obter uma descrição detalhada do erro.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído após a aceitação da conexão TCP.

Use o TcpClient.GetStream método para obter o subjacente NetworkStream do retornado TcpClient no Task<TResult>. O NetworkStream fornecerá métodos para enviar e receber com o host remoto. Quando você terminar com o TcpClient, certifique-se de chamar seu Close método. Se você quiser maior flexibilidade do que uma TcpClient oferta, considere usar AcceptSocket ou AcceptSocketAsync.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por AcceptTcpClient().

Confira também

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Origem:

TCPListener.cs

Aceita uma solicitação de conexão pendente como uma operação assíncrona cancelável.

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

Um token de cancelamento que pode ser usado para cancelar a operação assíncrona

Retornos

ValueTask<TcpClient>

O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna um TcpClient usado para enviar e receber dados.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído após a aceitação da conexão TCP.

Use o TcpClient.GetStream método para obter o subjacente NetworkStream do retornado TcpClient no Task<TResult>. O NetworkStream fornecerá métodos para enviar e receber com o host remoto. Quando você terminar com o TcpClient, certifique-se de chamar seu Close método. Se você quiser maior flexibilidade do que uma TcpClient oferta, considere usar AcceptSocket ou AcceptSocketAsync.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por AcceptTcpClient().