UdpClient.ReceiveAsync UdpClient.ReceiveAsync UdpClient.ReceiveAsync UdpClient.ReceiveAsync Method

Definición

Devuelve de forma asincrónica un datagrama UDP enviado por un host remoto.Returns a UDP datagram asynchronously that was sent by a remote host.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::UdpReceiveResult> ^ ReceiveAsync();
public System.Threading.Tasks.Task<System.Net.Sockets.UdpReceiveResult> ReceiveAsync ();
member this.ReceiveAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.UdpReceiveResult>
Public Function ReceiveAsync () As Task(Of UdpReceiveResult)

Devoluciones

Objeto de tarea que representa la operación asincrónica.The task object representing the asynchronous operation.

Excepciones

El objeto Socket subyacente se ha cerrado.The underlying Socket has been closed.

Se produjo un error al acceder al socket.An error occurred when accessing the socket.

Comentarios

Esta operación no se bloqueará.This operation will not block. El objeto Task<TResult>devuelto > se completará después de que se haya recibido el paquete UDP.The returned Task<TResult>> object will complete after the UDP packet has been received.

Si especifica un host remoto predeterminado en el Connect método, este método solo aceptará datagramas de ese host.If you specify a default remote host in the Connect method, this method will accept datagrams from that host only. Se descartarán todos los demás datagramas.All other datagrams will be discarded.

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. Una vez que haya obtenido este código, puede consultar la documentación de códigos de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Advertencia

Si piensa recibir datagramas multidifusión, no llame al Connect método antes de llamar a este método.If you intend to receive multicasted datagrams, do not call the Connect method prior to calling this method. El UdpClient que se usa para recibir datagramas se debe crear con el número de puerto de multidifusión.The UdpClient you use to receive datagrams must be created using the multicast port number.

Se aplica a