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
| Configuration requise | Description |
|---|---|
| Fonctionnalités de l’application |
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 le nom du service local ou l’adresse du numéro de port UDP spécifié dans le paramètre localServiceName . Si le paramètre localHostName a la valeur Null, le système sélectionne l’adresse IP locale sur laquelle lier. 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 BindEndpointAsync échoue si une autre application utilisant UDP (par exemple, un autre DatagramSocket) a déjà été lié à l’adresse IP locale et au port UDP spécifiés dans les paramètres localHostName et 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 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 :
- 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.