DatagramSocket.BindServiceNameAsync Méthode

Définition

Espace de noms:

Windows.Networking.Sockets

Surcharges

BindServiceNameAsync(String)	Démarre une opération de liaison d’un DatagramSocket à un nom de service local.
BindServiceNameAsync(String, NetworkAdapter)	Démarre une opération de liaison d’un DatagramSocket à un nom de service local et à une interface réseau spécifique.

BindServiceNameAsync(String)

Démarre une opération de liaison d’un DatagramSocket à un nom de service local.

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName);

function bindServiceNameAsync(localServiceName)

Public Function BindServiceNameAsync (localServiceName As String) As IAsyncAction

Paramètres

localServiceName

String

Platform::String

winrt::hstring

Nom du service local ou port UDP sur lequel lier l’objet DatagramSocket .

Retours

IAsyncAction

Opération de liaison asynchrone sur un objet DatagramSocket .

Attributs

RemoteAsyncAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Remarques

La méthode BindServiceNameAsync est liée aux adresses IP locales de toutes les interfaces réseau sur l’ordinateur local sur le nom de service local ou le port UDP spécifié dans le paramètre localServiceName . Si le paramètre localServiceName est une chaîne vide, le système sélectionne le port UDP local à lier.

Sauf si vous avez utilisé la propriété DatagramSocketControl.MulticastOnly , la méthode BindServiceNameAsync échouera si une autre application utilisant UDP (un autre DatagramSocket, par exemple) a déjà été liée au port UDP local spécifié dans le paramètre localServiceName .

La liaison est essentielle pour la réception de données à partir d’un point de terminaison distant sur un DatagramSocket. Elle est généralement effectuée après la création d’un socket et la définition de l’événement MessageReceived . La méthode BindServiceNameAsync ou BindEndpointAsync est utilisée pour lier un DatagramSocket à un nom de service local ou à un port UDP. Les méthodes ConnectAsync entraînent également une opération de liaison. L’écriture dans un flux retourné par l’une des méthodes GetOutputStreamAsync entraîne également une opération de liaison si le socket n’est pas déjà lié.

Les méthodes BindServiceNameAsync et BindEndpointAsync ne sont pas nécessaires dans les cas suivants :

• Le DatagramSocket est utilisé uniquement pour envoyer des données.
• Le DatagramSocket est utilisé pour envoyer des données à et recevoir des données à partir d’un point de terminaison unique.

Voir aussi

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation

BindServiceNameAsync(String, NetworkAdapter)

Démarre une opération de liaison d’un DatagramSocket à un nom de service local et à une interface réseau spécifique.

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName, NetworkAdapter ^ adapter) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, NetworkAdapter const& adapter);

[Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, NetworkAdapter adapter);

function bindServiceNameAsync(localServiceName, adapter)

Public Function BindServiceNameAsync (localServiceName As String, adapter As NetworkAdapter) As IAsyncAction

Paramètres

localServiceName

String

Platform::String

winrt::hstring

Nom du service local ou port UDP sur lequel lier l’objet DatagramSocket .

adapter

NetworkAdapter

Carte réseau sur laquelle lier l’objet DatagramSocket .

Retours

IAsyncAction

Opération de liaison asynchrone sur un objet DatagramSocket .

Attributs

OverloadAttribute RemoteAsyncAttribute

Remarques

La méthode [BindServiceNameAsync(String, NetworkAdapter) est liée à une interface réseau spécifiée dans le paramètre d’adaptateur et au nom du service local ou au port UDP spécifié dans le paramètre localServiceName sur l’ordinateur local. Si le paramètre localServiceName est une chaîne vide, le système sélectionne le port UDP local à lier. Si le paramètre de l’adaptateur est null, une erreur se produit.

Le mécanisme de résolution de noms utilisé par la méthode [BindServiceNameAsync(String, NetworkAdapter) est limité à l’interface spécifiée pour l’espace de noms DNS (Domain Name System).

Sauf si vous avez utilisé la propriété DatagramSocketControl.MulticastOnly , la méthode BindServiceNameAsync échoue si une autre application utilisant UDP (un autre DatagramSocket, par exemple) a déjà été liée au port UDP local spécifié dans le paramètre localServiceName sur la même interface réseau.

La liaison est essentielle pour la réception de données à partir d’un point de terminaison distant sur un DatagramSocket. Elle est généralement effectuée après la création d’un socket et la définition de l’événement MessageReceived . La méthode BindServiceNameAsync ou BindEndpointAsync est utilisée pour lier un DatagramSocket à un nom de service local ou à un port UDP. Les méthodes ConnectAsync entraînent également une opération de liaison, mais ne peuvent pas être limitées à une carte réseau spécifique. L’écriture dans un flux retourné par l’une des méthodes GetOutputStreamAsync entraîne également une opération de liaison si le socket n’est pas déjà lié, mais ne peut pas être limité à une carte réseau spécifique.

Les méthodes BindServiceNameAsync et BindEndpointAsync ne sont pas nécessaires dans les cas suivants :

• Le DatagramSocket est utilisé uniquement pour envoyer des données.
• Le DatagramSocket est utilisé pour envoyer des données à et recevoir des données à partir d’un point de terminaison unique.

Si la méthode [BindServiceNameAsync(String, NetworkAdapter) est utilisée, l’opération de liaison limite les paquets de multidiffusion et de unidiffusion entrants et sortants à l’adaptateur spécifié.

L’utilisation de la carte réseau spécifiée est optimale. Entre autres configurations, les systèmes avec des cartes configurées en mode hôte faible ou de transfert peuvent utiliser un adaptateur autre que l’adaptateur spécifié.

Voir aussi

• BindServiceNameAsync(String)
• BindEndpointAsync(HostName, String)
• DatagramSocketInformation