UdpClient.ReceiveAsync Methode

Definition

Gibt ein von einem Remotehost gesendetes UDP-Datagramm asynchron zurück.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)

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation.

Ausnahmen

Der zugrunde liegende Socket wurde geschlossen.The underlying Socket has been closed.

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.An error occurred when accessing the socket.

Hinweise

Dieser Vorgang wird nicht blockiert.This operation will not block. Der zurückgegebene Task<TResult>>-Objekt wird nach dem Empfang des UDP-Pakets abgeschlossen.The returned Task<TResult>> object will complete after the UDP packet has been received.

Wenn Sie einen Standard-Remote Host in der Connect-Methode angeben, akzeptiert diese Methode nur Datagramme von diesem Host.If you specify a default remote host in the Connect method, this method will accept datagrams from that host only. Alle anderen Datagramme werden verworfen.All other datagrams will be discarded.

Wenn Sie eine SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode, um den spezifischen Fehlercode abzurufen.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. Nachdem Sie diesen Code abgerufen haben, finden Sie in der API-Fehlercode Dokumentation der Windows Sockets, Version 2 , eine ausführliche Beschreibung des Fehlers.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.

Warnung

Wenn Sie beabsichtigen, multicasted Datagramme zu empfangen, rufen Sie die Connect-Methode nicht auf, bevor Sie diese Methode aufrufen.If you intend to receive multicasted datagrams, do not call the Connect method prior to calling this method. Der UdpClient, den Sie zum Empfangen von Datagrammen verwenden, muss mit der Multicast Portnummer erstellt werden.The UdpClient you use to receive datagrams must be created using the multicast port number.

Gilt für: