Sprache

DatagramSocketMessageReceivedEventArgs Klasse

Definition

Namespace:
Windows.Networking.Sockets
Bearbeiten

Stellt Daten für ein MessageReceived-Ereignis für ein 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

Anforderungen Beschreibung
Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

DatagramSocketMessageReceivedEventArgs wird verwendet, um Daten für ein 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 eine DatagramSocket-Instanz Daten überwachen und empfangen möchte. Diese Methoden sind nicht erforderlich, wenn das 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. Eine DatagramSocketMessageReceivedEventArgs-Instanz 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 Bytestrom in der empfangenen Nachricht darstellt. Die App muss dann den empfangenen Bytestrom 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 Byte, signierter und nicht signierter Ganzzahlen, boolescher Werte, einzelner und doppelter Gleitkommazahlen, Zeichenfolgen, Datums- und Zeitspannewerte, GUIDs und Puffer. Diese Methoden können direkt verwendet werden, um die empfangene Nachricht zu analysieren.

Eigenschaften

Name Beschreibung
LocalAddress

Ruft die lokale IP-Adresse ab, die einem DatagramSocket zugeordnet ist, wenn eine Nachricht empfangen wurde.
RemoteAddress

Ruft die IP-Adresse des Remote-Absenders des Datagrams im DatagramSocket ab, wenn eine Nachricht empfangen wird.
RemotePort

Ruft die UDP-Portnummer des Remote-Absenders des Datagrams ab, das im DatagramSocket empfangen wurde.

Methoden

Name Beschreibung
GetDataReader()

Ruft ein DataReader - Objekt ab, um eingehende Daten zu lesen, die vom Remotenetzwerkziel für ein DatagramSocket -Objekt empfangen werden.
GetDataStream()

Ruft ein IInputStream -Objekt, das einen sequenziellen Bytestrom darstellt, der als Nachricht vom Remotenetzwerkziel für ein DatagramSocket -Objekt gelesen werden soll.

Gilt für:

Siehe auch