DatagramSocketMessageReceivedEventArgs Classe

Définition

Fournit des données pour un événement MessageReceived sur un DatagramSocket.

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
Héritage
Object Platform::Object IInspectable DatagramSocketMessageReceivedEventArgs
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application
ID_CAP_NETWORKING [Windows Phone]

Remarques

Le DatagramSocketMessageReceivedEventArgs est utilisé pour recevoir des données sur un objet DatagramSocket .

La méthode DatagramSocket.BindServiceNameAsync ou DatagramSocket.BindEndpointAsync est utilisée pour lier un DatagramSocket à un nom de service local ou à un port UDP si un DatagramSocket instance souhaite écouter et recevoir des données. Ces méthodes ne sont pas nécessaires si le DatagramSocket doit être utilisé uniquement pour l’envoi de données.

Un événement DatagramSocket.MessageReceived se produit sur un DatagramSocket qui a été lié à un nom de service local ou à un port UDP lors de la réception d’un message. Une instance DatagramSocketMessageReceivedEventArgs est créée lorsque l’événement DatagramSocket.MessageReceived se produit.

Il existe deux méthodes principales pour lire les données lorsqu’un message a été reçu :

  • La méthode GetDataStream renvoie un objet Streams.IInputStream qui représente un flux séquentiel d’octets dans le message reçu. L’application doit ensuite analyser le flux d’octets reçu.
  • La méthode GetDataReader renvoie un objet Streams.DataReader pour lire les données entrantes. L’objet Streams.DataReader a des méthodes distinctes pour lire les données dans divers formats, notamment les octets, les entiers signés et non signés, les valeurs booléennes, les nombres à virgule flottante simple et double, les chaînes, les valeurs de date et d’intervalle de temps, les GUID et les mémoires tampons. Ces méthodes peuvent être utilisées directement pour analyser le message reçu.

Propriétés

LocalAddress

Obtient l’adresse IP locale associée à un DatagramSocket lors de la réception d’un message.

RemoteAddress

Obtient l’adresse IP de l’expéditeur distant du datagramme sur le DatagramSocket lorsqu’un message est reçu.

RemotePort

Obtient le numéro de port UDP de l’expéditeur distant du datagramme reçu sur le DatagramSocket.

Méthodes

GetDataReader()

Obtient un objet DataReader pour lire les données entrantes reçues de la destination réseau distante sur un objet DatagramSocket .

GetDataStream()

Obtient un objet IInputStream qui représente un flux séquentiel d’octets à lire en tant que message à partir de la destination réseau distante sur un objet DatagramSocket .

S’applique à

Voir aussi