Partager via


DatagramSocket.BindEndpointAsync(HostName, String) Méthode

Définition

Démarre une opération de liaison sur un DatagramSocket à un nom d’hôte local et à un nom de service local.

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);
function bindEndpointAsync(localHostName, localServiceName)
Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

Paramètres

localHostName
HostName

Nom d’hôte local ou adresse IP sur laquelle lier l’objet DatagramSocket .

localServiceName
String

Platform::String

winrt::hstring

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

Retours

Opération de liaison asynchrone sur un objet DatagramSocket .

Attributs

Configuration requise pour Windows

Fonctionnalités de l’application
ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Remarques

La méthode BindEndpointAsync lie datagramSocket au nom d’hôte local ou à l’adresse IP spécifiée dans le paramètre localHostName et au nom de service local ou à l’adresse de numéro de port UDP spécifiée dans le paramètre localServiceName . Si le paramètre localHostName est null, le système sélectionne l’adresse IP locale à lier. 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 BindEndpointAsync échoue si une autre application utilisant UDP (par exemple, un autre DatagramSocket) a déjà été liée à l’adresse IP locale et au port UDP spécifiés dans les paramètres localHostName et 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 si le socket n’est pas déjà lié. L’écriture dans un flux retourné par l’une des méthodes GetOutputStreamAsync entraîne également une opération de liaison.

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.

S’applique à

Voir aussi