TcpListener.AcceptSocketAsync 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
| AcceptSocketAsync() |
Aceita uma solicitação de conexão pendente como uma operação assíncrona. |
| AcceptSocketAsync(CancellationToken) |
Aceita uma solicitação de conexão pendente como uma operação assíncrona cancelável. |
AcceptSocketAsync()
- 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::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)Retornos
O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto da tarefa retorna um Socket usado para enviar e receber dados.
Exceções
O ouvinte não foi iniciado com uma chamada para Start().
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que a conexão de soquete for aceita.
O Socket retornado em Task<TResult> é inicializado com o endereço IP e o número da porta do host remoto. Você pode usar qualquer um dos Send métodos e Receive disponíveis na Socket classe para se comunicar com o host remoto. Quando terminar de usar o Socket, certifique-se de chamar seu Close método . Se o aplicativo for relativamente simples, considere usar o AcceptTcpClient método em vez do AcceptSocketAsync método . TcpClient fornece métodos simples para enviar e receber dados em uma rede no modo síncrono de bloqueio.
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 a contraparte síncrona 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 AcceptSocket().
Confira também
Aplica-se a
AcceptSocketAsync(CancellationToken)
- 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::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
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 propriedade Result no objeto da tarefa retorna um Socket usado para enviar e receber dados.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que a conexão de soquete for aceita.
O Socket retornado em Task<TResult> é inicializado com o endereço IP e o número da porta do host remoto. Você pode usar qualquer um dos Send métodos e Receive disponíveis na Socket classe para se comunicar com o host remoto. Quando terminar de usar o Socket, certifique-se de chamar seu Close método . Se o aplicativo for relativamente simples, considere usar o AcceptTcpClient método em vez do AcceptSocketAsync método . TcpClient fornece métodos simples para enviar e receber dados em uma rede no modo síncrono de bloqueio.
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 a contraparte síncrona 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 AcceptSocket().
