DatagramSocket.BindEndpointAsync(HostName, String) Método

Definição

Namespace:

Windows.Networking.Sockets

Inicia uma operação de associação em um DatagramSocket para um nome de host local e um nome de serviço 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 IAsyncAction

Parâmetros

localHostName

HostName

O nome do host local ou o endereço IP no qual associar o objeto DatagramSocket .

localServiceName

String

Platform::String

winrt::hstring

O nome do serviço local ou a porta UDP na qual associar o objeto DatagramSocket .

Retornos

IAsyncAction

Uma operação de associação assíncrona em um objeto DatagramSocket .

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Comentários

O método BindEndpointAsync associa o DatagramSocket ao nome do host local ou ao endereço IP especificado no parâmetro localHostName e ao nome do serviço local ou ao endereço de número da porta UDP especificado no parâmetro localServiceName . Se o parâmetro localHostName for nulo, o sistema selecionará o endereço IP local no qual associar. Se o parâmetro localServiceName for uma cadeia de caracteres vazia, o sistema selecionará a porta UDP local na qual associar.

A menos que você tenha usado a propriedade DatagramSocketControl.MulticastOnly , o método BindEndpointAsync falhará se outro aplicativo usando UDP (por exemplo, outro DatagramSocket) já tiver sido associado ao endereço IP local e à porta UDP especificada nos parâmetros localHostName e localServiceName .

A associação é essencial para receber dados de qualquer ponto de extremidade remoto em um DatagramSocket e normalmente é feita depois que um soquete é criado e o evento MessageReceived foi definido. O método BindServiceNameAsync ou BindEndpointAsync é usado para associar um DatagramSocket a um nome de serviço local ou porta UDP. Os métodos ConnectAsync também resultarão em uma operação de associação se o soquete ainda não estiver associado. Gravar em um fluxo retornado por um dos métodos GetOutputStreamAsync também resultará em uma operação de associação.

Os métodos BindServiceNameAsync e BindEndpointAsync não são necessários nos seguintes casos:

• O DatagramSocket é usado apenas para enviar dados.
• O DatagramSocket é usado para enviar dados e receber dados de um único ponto de extremidade.

Confira também

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived