DatagramSocket.BindEndpointAsync(HostName, String) Méthode
Définition
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.
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 IAsyncActionParamè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.