TcpListener.AcceptTcpClientAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| AcceptTcpClientAsync() |
Aceita um pedido de ligação pendente como uma operação assíncrona. |
| AcceptTcpClientAsync(CancellationToken) |
Aceita um pedido de ligaçã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 um pedido de ligaçã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)Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um TcpClient usado para enviar e receber dados.
Exceções
O ouvinte ainda não foi iniciado com uma chamada para Start().
Use a ErrorCode propriedade para obter o código de erro específico. Quando obter este código, pode consultar a documentação do código de erro da API Windows Sockets versão 2 para uma descrição detalhada do erro.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído após a aceitação da ligação TCP.
Use o TcpClient.GetStream método para obter o subjacente NetworkStream do retornado TcpClient no Task<TResult>. Eles NetworkStream fornecer-lhe-ão métodos para enviar e receber com o host remoto. Quando terminar com o TcpClient, certifique-se de chamar o seu Close método. Se 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 mais informações, consulte Rastreamento de Rede no .NET Framework.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AcceptTcpClient().
Ver também
Aplica-se a
AcceptTcpClientAsync(CancellationToken)
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
- Origem:
- TCPListener.cs
Aceita um pedido de ligaçã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
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um TcpClient usado para enviar e receber dados.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído após a aceitação da ligação TCP.
Use o TcpClient.GetStream método para obter o subjacente NetworkStream do retornado TcpClient no Task<TResult>. Eles NetworkStream fornecer-lhe-ão métodos para enviar e receber com o host remoto. Quando terminar com o TcpClient, certifique-se de chamar o seu Close método. Se 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 mais informações, consulte Rastreamento de Rede no .NET Framework.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AcceptTcpClient().
