DatagramSocket.BindEndpointAsync(HostName, String) Metodo

Definizione

Spazio dei nomi:

Windows.Networking.Sockets

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 IAsyncAction

Parametri

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

IAsyncAction

Operazione di associazione asincrona in un oggetto DatagramSocket .

Attributi

RemoteAsyncAttribute

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.

Vedi anche

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived