TcpListener.AcceptTcpClientAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| 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
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- 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
O objeto de tarefa que representa a operação assíncrona. A Result propriedade no objeto de tarefa retorna um TcpClient usado para enviar e receber dados.
Exceções
O ouvinte não foi iniciado com uma chamada para Start().
Use a ErrorCode propriedade para obter o código de erro específico. Quando você tiver obtido esse código, poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 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>. Ele NetworkStream fornecerá métodos para enviar e receber com o host remoto. Quando terminar com o TcpClientmétodo, certifique-se de chamar seu Close método. Se você quiser maior flexibilidade do que uma TcpClient oferta, considere usar AcceptSocket ou AcceptSocketAsync.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Network Tracing in the .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
Aplica-se a
AcceptTcpClientAsync(CancellationToken)
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- 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
O objeto de tarefa que representa a operação assíncrona. A Result propriedade no objeto de tarefa retorna um TcpClient usado para enviar e receber dados.
Exceções
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>. Ele NetworkStream fornecerá métodos para enviar e receber com o host remoto. Quando terminar com o TcpClientmétodo, certifique-se de chamar seu Close método. Se você quiser maior flexibilidade do que uma TcpClient oferta, considere usar AcceptSocket ou AcceptSocketAsync.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Network Tracing in the .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().
