DatagramSocket.BindServiceNameAsync Metodo

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName);

function bindServiceNameAsync(localServiceName)

Public Function BindServiceNameAsync (localServiceName As String) As IAsyncAction

Parametri

Valori restituiti

Operazione di associazione asincrona in un oggetto DatagramSocket .

Attributi

RemoteAsyncAttribute

Requisiti Windows

Commenti

Il metodo BindServiceNameAsync viene associato agli indirizzi IP locali di tutte le interfacce di rete nel computer locale nel nome del servizio locale o alla porta UDP specificata nel parametro localServiceName . 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 BindServiceNameAsync avrà esito negativo se un'altra app che usa UDP (un altro DatagramSocket, ad esempio) è già stata associata alla porta UDP locale specificata nel parametro 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. La scrittura in un flusso restituito da uno dei metodi GetOutputStreamAsync genererà anche un'operazione di associazione se il socket non è già associato.

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.

Vedi anche

• BindEndpointAsync(HostName, String)
• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation

public:
 virtual IAsyncAction ^ BindServiceNameAsync(Platform::String ^ localServiceName, NetworkAdapter ^ adapter) = BindServiceNameAsync;

/// [Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindServiceNameAsync(winrt::hstring const& localServiceName, NetworkAdapter const& adapter);

[Windows.Foundation.Metadata.Overload("BindServiceNameAndAdapterAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindServiceNameAsync(string localServiceName, NetworkAdapter adapter);

function bindServiceNameAsync(localServiceName, adapter)

Public Function BindServiceNameAsync (localServiceName As String, adapter As NetworkAdapter) As IAsyncAction

Parametri

Valori restituiti

Operazione di associazione asincrona in un oggetto DatagramSocket .

Attributi

OverloadAttribute RemoteAsyncAttribute

Commenti

Il metodo [BindServiceNameAsync(String, NetworkAdapter) viene associato a un'interfaccia di rete specificata nel parametro adapter e al nome del servizio locale o alla porta UDP specificata nel parametro localServiceName nel computer locale. Se il parametro localServiceName è una stringa vuota, il sistema selezionerà la porta UDP locale su cui eseguire l'associazione. Se il parametro dell'adapter è Null, si verificherà un errore.

Il meccanismo di risoluzione dei nomi usato dal metodo [BindServiceNameAsync(String, NetworkAdapter) è limitato all'interfaccia specificata per lo spazio dei nomi DNS (Domain Name System).

A meno che non sia stata usata la proprietà DatagramSocketControl.MulticastOnly , il metodo BindServiceNameAsync avrà esito negativo se un'altra app che usa UDP (un altro DatagramSocket, ad esempio) è già stata associata alla porta UDP locale specificata nel parametro localServiceName nella stessa interfaccia di rete.

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, ma non possono essere limitati a una scheda di rete specifica. La scrittura in un flusso restituito da uno dei metodi GetOutputStreamAsync genererà anche un'operazione di associazione se il socket non è già associato, ma non può essere limitato a una scheda di rete specifica.

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.

Se viene utilizzato il metodo [BindServiceNameAsync(String, NetworkAdapter), l'operazione di associazione limiterà i pacchetti multicast in ingresso e in uscita e unicast alla scheda specificata.

L'uso della scheda di rete specificata è su base ottimale. Tra le altre configurazioni, i sistemi con adattatori configurati in modalità host debole o inoltro possono usare una scheda diversa dalla scheda specificata.

Vedi anche

• BindServiceNameAsync(String)
• BindEndpointAsync(HostName, String)
• DatagramSocketInformation