DatagramSocket.BindServiceNameAsync Méthode

Définition

Espace de noms:: Windows.Networking.Sockets

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

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

BindServiceNameAsync(String)

Modifier

Démarre une opération de liaison sur 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

Configuration requise	Description
Fonctionnalités de l’application	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 sur lequel lier.

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é au port UDP local spécifié dans le paramètre localServiceName .

La liaison est essentielle pour recevoir des données à partir de n’importe quel point de terminaison distant sur un DatagramSocket et est généralement effectuée après la création d’un socket et l’événement MessageReceived a été défini. 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 :

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

Voir aussi

S’applique à

BindServiceNameAsync(String, NetworkAdapter)

Modifier

Démarre une opération de liaison sur 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 de l’adaptateur et le nom du service local ou le 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 sur lequel lier. Si le paramètre de l’adaptateur a la valeur 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).

La liaison est essentielle pour recevoir des données à partir de n’importe quel point de terminaison distant sur un DatagramSocket et est généralement effectuée après la création d’un socket et l’événement MessageReceived a été défini. 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 :

DatagramSocket est utilisé uniquement pour envoyer des données.
DatagramSocket est utilisé pour envoyer des données vers 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 entrants et sortants à l’adaptateur spécifié.

L’utilisation de la carte réseau spécifiée est optimale. Parmi d’autres configurations, les systèmes avec des adaptateurs configurés dans des modes d’hôte faible ou de transfert peuvent utiliser un adaptateur autre que l’adaptateur spécifié.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?