DatagramSocket.BindEndpointAsync(HostName, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 IAsyncActionParâ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
Uma operação de associação assíncrona em um objeto DatagramSocket .
- Atributos
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.