DatagramSocket.BindEndpointAsync(HostName, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia un'operazione di associazione in un oggetto DatagramSocket a un nome host locale e a un nome di servizio locale.
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 IAsyncActionParametri
- localHostName
- HostName
Nome host locale o indirizzo IP in cui associare l'oggetto DatagramSocket .
- localServiceName
-
String
Platform::String
winrt::hstring
Nome del servizio locale o porta UDP su cui associare l'oggetto DatagramSocket .
Valori restituiti
Operazione di associazione asincrona in un oggetto DatagramSocket .
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| Funzionalità dell'app |
internetClientServer
privateNetworkClientServer
|
Commenti
Il metodo BindEndpointAsync associa DatagramSocket al nome host locale o all'indirizzo IP specificato nel parametro localHostName e l'indirizzo del nome del servizio locale o dell'indirizzo del numero di porta UDP specificato nel parametro localServiceName . Se il parametro localHostName è null, il sistema selezionerà l'indirizzo IP locale in cui eseguire l'associazione. Se il parametro localServiceName è una stringa vuota, il sistema selezionerà la porta UDP locale su cui eseguire l'associazione.
A meno che non sia stata usata la proprietà DatagramSocketControl.MulticastOnly , il metodo BindEndpointAsync avrà esito negativo se un'altra app che usa UDP (ad esempio, un altro DatagramSocket) è già stata associata all'indirizzo IP locale e alla porta UDP specificata nei parametri localHostName e localServiceName .
L'associazione è essenziale per la ricezione di dati da qualsiasi endpoint remoto in un oggetto DatagramSocket e viene in genere eseguita dopo la creazione di un socket e l'evento MessageReceived è stato impostato. Il metodo BindServiceNameAsync o BindEndpointAsync viene usato per associare un oggetto DatagramSocket a un nome di servizio locale o a una porta UDP. I metodi ConnectAsync genereranno anche un'operazione di associazione se il socket non è già associato. La scrittura in un flusso restituito da uno dei metodi GetOutputStreamAsync genererà anche un'operazione di associazione.
I metodi BindServiceNameAsync e BindEndpointAsync non sono necessari nei casi seguenti:
- DatagramSocket viene usato solo per inviare dati.
- DatagramSocket viene usato per inviare e ricevere dati da un singolo endpoint.