Ler em inglês

Partilhar via


UdpClient.ReceiveAsync Método

Definição

Sobrecargas

ReceiveAsync()

Retorna um datagrama UDP de forma assíncrona que foi enviado por um host remoto.

ReceiveAsync(CancellationToken)

Retorna um datagrama UDP de forma assíncrona que foi enviado por um host remoto.

ReceiveAsync()

Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs

Retorna um datagrama UDP de forma assíncrona que foi enviado por um host remoto.

C#
public System.Threading.Tasks.Task<System.Net.Sockets.UdpReceiveResult> ReceiveAsync();

Retornos

O objeto de tarefa que representa a operação assíncrona.

Exceções

O Socket subjacente foi fechado.

Ocorreu um erro ao acessar o soquete.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult>> será concluído depois que o pacote UDP for recebido.

Se você especificar um host remoto padrão no Connect método , esse método aceitará apenas datagrams desse host. Todos os outros datagramas serão descartados.

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você 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.

Aviso

Se você pretende receber datagramas multicast, não chame o Connect método antes de chamar esse método. O UdpClient que você usa para receber datagramas deve ser criado usando o número da porta multicast.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

ReceiveAsync(CancellationToken)

Origem:
UDPClient.cs
Origem:
UDPClient.cs
Origem:
UDPClient.cs

Retorna um datagrama UDP de forma assíncrona que foi enviado por um host remoto.

C#
public System.Threading.Tasks.ValueTask<System.Net.Sockets.UdpReceiveResult> ReceiveAsync(System.Threading.CancellationToken cancellationToken);

Parâmetros

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.

Retornos

Um ValueTask<TResult> representando a operação assíncrona.

Exceções

O Socket subjacente foi fechado.

Ocorreu um erro ao acessar o soquete.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET 6, 7, 8, 9, 10