TcpListener.AcceptSocketAsync Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

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

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

Task<Socket>

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

InvalidOperationException

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

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(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::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

ValueTask<Socket>

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

OperationCanceledException

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