Socket.AcceptAsync Método

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptAsync ();

member this.AcceptAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>

Public Function AcceptAsync () As Task(Of Socket)

Retornos

Uma tarefa assíncrona que é concluída com o Soquete aceito.

Exceções

Comentários

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 Accept().

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptAsync(System::Net::Sockets::Socket ^ acceptSocket);

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptAsync (System.Net.Sockets.Socket? acceptSocket);

member this.AcceptAsync : System.Net.Sockets.Socket -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>

Public Function AcceptAsync (acceptSocket As Socket) As Task(Of Socket)

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída com o Soquete aceito.

Exceções

Origem:

Socket.cs

Origem:

Socket.cs

Origem:

Socket.cs

public:
 bool AcceptAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool AcceptAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.AcceptAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function AcceptAsync (e As SocketAsyncEventArgs) As Boolean

Parâmetros

Retornos

true se a operação de E/S está pendente. O evento Completed no parâmetro e será acionado após a conclusão da operação.

false se a operação de E/S foi concluída de forma síncrona. O evento Completed no parâmetro e não será acionado e o objeto e passado como um parâmetro poderá ser examinado imediatamente depois que a chamada do método for retornada para recuperar o resultado da operação.

Exceções

Comentários

Os protocolos orientados à conexão podem usar o AcceptAsync método para processar as tentativas de conexão de entrada de forma assíncrona. Aceitar conexões de forma assíncrona oferece a capacidade de enviar e receber dados em um thread de execução separado. Antes de chamar o AcceptAsync método , você deve chamar o Listen método para escutar e enfileirar solicitações de conexão de entrada.

Para ser notificado sobre a conclusão, você deve criar um método de retorno de chamada que implemente o delegado EventHandler<SocketAsyncEventArgs> e conecte-o ao SocketAsyncEventArgs.Completed evento.

As seguintes propriedades e eventos no System.Net.Sockets.SocketAsyncEventArgs objeto são necessários:

• SocketAsyncEventArgs.Completed

Opcionalmente, o chamador pode especificar um existente Socket a ser usado para a conexão de entrada especificando o Socket a ser usado com a SocketAsyncEventArgs.AcceptSocket propriedade .

Se a SocketAsyncEventArgs.AcceptSocket propriedade for nula, um novo Socket será construído com o mesmo AddressFamily, SocketTypee ProtocolType como o atual Socket e definido como a SocketAsyncEventArgs.AcceptSocket propriedade .

O chamador pode definir a SocketAsyncEventArgs.UserToken propriedade como qualquer objeto de estado de usuário desejado antes de chamar o AcceptAsync método, para que as informações sejam recuperadas no método de retorno de chamada. Se o retorno de chamada precisar de mais informações do que um único objeto, uma classe pequena poderá ser criada para manter as outras informações de estado necessárias como membros.

Opcionalmente, um buffer pode ser fornecido para receber o bloco inicial de dados no soquete depois que o ConnectAsync método for bem-sucedido. Nesse caso, a SocketAsyncEventArgs.Buffer propriedade precisa ser definida como o buffer que contém os dados a serem recebidos e a SocketAsyncEventArgs.Count propriedade precisa ser definida como o número máximo de bytes de dados a serem recebidos no buffer. Essas propriedades podem ser definidas usando o SocketAsyncEventArgs.SetBuffer método . Parte do buffer passado será consumida internamente para uso pela chamada AcceptEx do Winsock subjacente. Isso significa que a quantidade de dados retornados sempre será menor que o valor da SocketAsyncEventArgs.Count propriedade na System.Net.Sockets.SocketAsyncEventArgs instância fornecida. A quantidade do buffer usado internamente varia de acordo com a família de endereços do soquete. O tamanho mínimo do buffer necessário é de 288 bytes. Se um tamanho de buffer maior for especificado, o Socket esperará alguns dados extras além dos dados de endereço recebidos pela chamada Winsock AcceptEx e aguardará até que esses dados extras sejam recebidos. Se ocorrer um tempo limite, a conexão será redefinida. Portanto, se forem esperados dados extras de um valor específico, o tamanho do buffer deverá ser definido como o tamanho mínimo do buffer mais esse valor.

O método de retorno de chamada de conclusão deve examinar a SocketAsyncEventArgs.SocketError propriedade para determinar se a AcceptAsync operação foi bem-sucedida.

O SocketAsyncEventArgs.Completed evento pode ocorrer em alguns casos quando nenhuma conexão foi aceita e fazer com que a SocketAsyncEventArgs.SocketError propriedade seja definida ConnectionResetcomo . Isso pode ocorrer como resultado da verificação de porta usando uma verificação de tipo SYN semiaberto (uma sequência SYN -> SYN-ACK -> RST). Os aplicativos que usam o AcceptAsync método devem estar preparados para lidar com essa condição.

Confira também

• SocketAsyncEventArgs
• AcceptSocket
• Buffer
• Completed
• Count
• UserToken

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>

Public Function AcceptAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída com o Soquete aceito.

Exceções

Comentários

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 Accept().

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptAsync(System::Net::Sockets::Socket ^ acceptSocket, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptAsync (System.Net.Sockets.Socket? acceptSocket, System.Threading.CancellationToken cancellationToken);

member this.AcceptAsync : System.Net.Sockets.Socket * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>

Public Function AcceptAsync (acceptSocket As Socket, cancellationToken As CancellationToken) As ValueTask(Of Socket)

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída com o Soquete aceito.

Exceções