DatagramSocketMessageReceivedEventArgs Klasse

Referenz

Definition

Namespace:: Windows.Networking.Sockets

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Daten für ein MessageReceived-Ereignis in einem DatagramSocket bereit.

public ref class DatagramSocketMessageReceivedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DatagramSocketMessageReceivedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DatagramSocketMessageReceivedEventArgs

Public NotInheritable Class DatagramSocketMessageReceivedEventArgs

Vererbung: Object Platform::Object IInspectable DatagramSocketMessageReceivedEventArgs

Attribute: ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	ID_CAP_NETWORKING [Windows Phone]

Hinweise

DatagramSocketMessageReceivedEventArgs wird verwendet, um Daten zu einem DatagramSocket-Objekt zu empfangen.

Die DatagramSocket.BindServiceNameAsync- oder DatagramSocket.BindEndpointAsync-Methode wird verwendet, um ein DatagramSocket an einen lokalen Dienstnamen oder UDP-Port zu binden, wenn ein DatagramSocket-instance Daten lauschen und empfangen möchte. Diese Methoden sind nicht erforderlich, wenn datagramSocket nur zum Senden von Daten verwendet werden soll.

Ein DatagramSocket.MessageReceived-Ereignis tritt auf einem DatagramSocket auf, das an einen lokalen Dienstnamen oder UDP-Port gebunden wurde, wenn eine Nachricht empfangen wird. Ein DatagramSocketMessageReceivedEventArgs-instance wird erstellt, wenn das DatagramSocket.MessageReceived-Ereignis auftritt.

Es gibt zwei primäre Methoden zum Lesen von Daten, wenn eine Nachricht empfangen wurde:

Die GetDataStream-Methode gibt ein Streams.IInputStream-Objekt zurück, das einen sequenziellen Bytedatenstrom in der empfangenen Nachricht darstellt. Die App muss dann den empfangenen Bytedatenstrom analysieren.
Die GetDataReader-Methode gibt ein Streams.DataReader-Objekt zurück, um eingehende Daten zu lesen. Das Streams.DataReader-Objekt verfügt über separate Methoden zum Lesen der Daten in einer Vielzahl von Formaten, einschließlich Bytes, ganzzahliger und unsignierter Zahlen, boolescher Werte, einfacher und doppelter Gleitkommazahlen, Zeichenfolgen, Datums- und Zeitbereichswerte, GUIDs und Puffer. Diese Methoden können direkt verwendet werden, um die empfangene Nachricht zu analysieren.

Eigenschaften

LocalAddress	Ruft die lokale IP-Adresse ab, die einem DatagramSocket zugeordnet ist, wenn eine Nachricht empfangen wurde.
RemoteAddress	Ruft die IP-Adresse des Remotesenders des Datagramms im DatagramSocket ab, wenn eine Nachricht empfangen wird.
RemotePort	Ruft die UDP-Portnummer des Remotesenders des Datagramms ab, das auf dem DatagramSocket empfangen wurde.

Methoden

GetDataReader()	Ruft ein DataReader-Objekt zum Lesen eingehender Daten ab, die vom Remotenetzwerkziel in einem DatagramSocket-Objekt empfangen werden.
GetDataStream()	Ruft ein IInputStream-Objekt ab, das einen sequenziellen Bytedatenstrom darstellt, der als Nachricht vom Remotenetzwerkziel für ein DatagramSocket-Objekt gelesen werden soll.

Gilt für:

Freigeben über