DatagramSocket Classe

Définition

public ref class DatagramSocket sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DatagramSocket final : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DatagramSocket final : IClosable

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DatagramSocket : System.IDisposable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DatagramSocket : System.IDisposable

function DatagramSocket()

Public NotInheritable Class DatagramSocket
Implements IDisposable

Héritage

Object Platform::Object IInspectable DatagramSocket

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Remarques

La classe DatagramSocket prend en charge la communication réseau à l’aide d’un socket de datagramme UDP. L’objet DatagramSocket peut être utilisé pour les applications clientes qui envoient des paquets UDP ou pour les applications serveur qui écoutent les données UDP entrantes.

Plusieurs étapes sont nécessaires pour envoyer ou recevoir des données à l’aide d’un objet DatagramSocket. Votre application affecte d’abord l’événement MessageReceived à un gestionnaire d’événements. Pour écouter les paquets entrants à partir d’un point de terminaison distant (un scénario de serveur, par exemple), votre application appelle la méthode BindEndpointAsync ou BindServiceNameAsync pour lier le DatagramSocket à un nom de service local ou à un port UDP. Toutefois, lorsque votre application doit communiquer avec un seul point de terminaison distant (scénario client, par exemple), votre application appelle la méthode ConnectAsync . Le gestionnaire d’événements MessageReceived doit être défini avant toute opération de liaison ou de connexion, sinon une erreur se produit.

L’ordre classique des opérations est le suivant :

1. Créez le DatagramSocket.
2. Utilisez la propriété Control pour récupérer un objet DatagramSocketControl et définir les contrôles avancés. Cette étape n’est normalement pas nécessaire pour la plupart des applications.
3. Affectez l’événement MessageReceived à un gestionnaire d’événements.
4. Pour écouter les paquets entrants à partir d’un point de terminaison distant (scénario serveur, par exemple), appelez la méthode BindEndpointAsync ou BindServiceNameAsync pour lier le DatagramSocket à un nom de service local ou à un port UDP.
5. Pour communiquer avec un seul point de terminaison distant (scénario client, par exemple), appelez la méthode ConnectAsync pour lier datagramSocket à un point de terminaison distant spécifique.
6. Le gestionnaire d’événements MessageReceived est appelé chaque fois qu’un message provenant du point de terminaison distant arrive. Cette classe peut également être utilisée pour joindre un groupe de multidiffusion et envoyer des paquets UDP au groupe de multidiffusion. Pour plus d’informations, consultez la méthode JoinMulticastGroup .

Gestion des exceptions

Vous devez écrire du code pour gérer les exceptions lorsque vous appelez des méthodes asynchrones sur la classe DatagramSocket. Les exceptions peuvent résulter d’erreurs de validation de paramètre, d’échecs de résolution de noms et d’erreurs réseau. Les exceptions des erreurs réseau (perte de connectivité, échecs de connexion et défaillances de serveur, par exemple) peuvent se produire à tout moment. Ces erreurs donnent lieu à la levée d’exceptions. Si elle n’est pas gérée par votre application, une exception peut entraîner l’arrêt de l’ensemble de votre application par le runtime.

L’espace de noms Windows.Networking.Sockets a une méthode d’assistance et une énumération pratiques pour gérer les erreurs lors de l’utilisation de sockets. Ceci peut s’avérer utile pour gérer différemment certaines exceptions réseau dans votre application. Une application peut également utiliser le HRESULT de l’exception sur les erreurs de validation de paramètre pour obtenir des informations plus détaillées sur l’erreur à l’origine de l’exception.

Pour plus d’informations sur les exceptions possibles et sur la façon de gérer les exceptions, consultez Gestion des exceptions dans les applications réseau.

Utilisation de DatagramSocket avec Wi-Fi Direct

Votre application peut utiliser un DatagramSocket pour les transferts de données réseau entre des appareils qui utilisent Wi-Fi Direct à l’aide de classes dans l’espace de noms Windows.Devices.WiFiDirect . La classe WiFiDirectDevice peut être utilisée pour localiser d’autres appareils qui ont un appareil Wi-Fi Direct (WFD). La méthode WiFiDirectDevice.GetDeviceSelector obtient l’identificateur d’appareil d’un appareil WFD à proximité. Une fois que vous disposez d’une référence à un appareil WFD à proximité, vous pouvez appeler la méthode WiFiDirectDevice.GetConnectionEndpointPairs pour obtenir un objet EndpointPair . Les méthodes de la classe DatagramSocket peuvent être utilisées pour envoyer et recevoir des données à l’objet EndpointPair . Pour plus d’informations, consultez Windows.Devices.WiFiDirect et WiFiDirectDevice.

Utilisation de DatagramSocket sur Windows Server 2012

Sur Windows Server 2012 et Windows Server 2012 R2, le Windows.Networking.dll qui implémente la plupart des classes dans l’espace de noms Windows.Networking.Sockets ne peut pas se charger, sauf si la fonctionnalité Media Foundation est activée. Par conséquent, les applications qui utilisent DatagramSocket et les classes de socket associées dans l’espace de noms Windows.Networking.Sockets échouent si la fonctionnalité Media Foundation est désactivée. Windows Server 2012 ou Windows Server 2012 R2 s’installe avec la fonctionnalité Media Foundation désactivée.

La fonctionnalité Media Foundation peut être activée sur Windows Server 2012 ou Windows Server 2012 R2 à l’aide de Gestionnaire de serveur ou en entrant le texte suivant dans une invite de commandes ou un script :

dism /online /enable-feature /featurename:ServerMediaFoundation Une fois la fonctionnalité Media Foundation activée, l’utilisateur est invité à redémarrer. Une fois l’ordinateur redémarré, les classes pour sockets et WebSockets dans l’espace de noms Windows.Networking.Sockets fonctionnent comme prévu.

Résolution des enregistrements de service DNS à l’aide de DatagramSocket

Une application peut communiquer avec l’adresse DNS cible qui appartient à un enregistrement SRV. Par exemple, une traversée simple d’UDP via le service STUN (Network Address Translation) dans le domaine Contoso correspond à _stun._udp.contoso.com. Ce nom de service correspond à un nom DNS de serveur, par exemple. stunServer01.contoso.com

Pour vous connecter à l’adresse DNS du serveur pour ce service, utilisez l’appel de méthode suivant sur un datagramSocket instance :

using Windows.Networking.Sockets;

DatagramSocket socket = new DatagramSocket();
socket.ConnectAsync(new HostName("contoso.com"), "stun");

Le protocole est déduit comme UDP pour les instances DatagramSocket. La méthode traite des caractères de soulignement.

Un DNS peut être configuré pour avoir une hiérarchie SRV. Un enregistrement de ressource SRV DNS peut avoir la forme suivante : _stun._service01._udp.contoso.com. Pour cet exemple, utilisez l’appel de méthode suivant sur un instance DatagramSocket :

socket.ConnectAsync(new HostName("contoso.com"), "stun._service01");

Ces extraits de code utilisent ConnectAsync. Les méthodes GetOutputStreamAsync et GetEndpointPairsAsync prennent en charge une utilisation similaire pour se connecter aux services.

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• DatagramSocketControl
• DatagramSocketInformation
• DatagramSocketMessageReceivedEventArgs
• IClosable
• Sockets
• Connexion avec des sockets
• Gestion des exceptions dans les applications réseau
• Comment se connecter avec un socket de datagramme
• Comment se connecter avec un socket de datagramme
• Comment utiliser des contrôles de socket avancés
• Résoudre les problèmes et déboguer les connexions réseau
• SetSocketMediaStreamingMode
• Exemple DatagramSocket
• Exemple DatagramSocket (Windows 10)