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 datagramSocket a un nome host locale e a un nome del 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 in cui associare l'oggetto DatagramSocket .
Restituisce
Operazione di associazione asincrona in un oggetto DatagramSocket .
- Attributi
Requisiti Windows
| Funzionalità dell'app |
ID_CAP_NETWORKING [Windows Phone]
internetClientServer
privateNetworkClientServer
|
Commenti
Il metodo BindEndpointAsync associa l'indirizzo DatagramSocket al nome host locale o all'indirizzo IP specificato nel parametro localHostName e l'indirizzo del numero di porta UDP o nome del servizio locale specificato nel parametro localServiceName . Se il parametro localHostName è Null, il sistema selezionerà l'indirizzo IP locale su cui associare. Se il parametro localServiceName è una stringa vuota, il sistema selezionerà la porta UDP locale su cui associare.
A meno che non sia stata usata la proprietà DatagramSocketControl.MulticastOnly, il metodo BindEndpointAsync avrà esito negativo se un'altra app usando 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 ricevere dati da qualsiasi endpoint remoto in un datagramSocket e viene comunemente eseguita dopo la creazione di un socket e l'evento MessageReceived è stato impostato. Il metodo BindServiceNameAsync o BindEndpointAsync viene usato per associare un datagramSocket a un nome del servizio locale o a una porta UDP. I metodi ConnectAsync comportano anche un'operazione di associazione se il socket non è già associato. La scrittura in un flusso restituito da uno dei metodi GetOutputStreamAsync comporta 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 dati a e ricevere dati da un singolo endpoint.