DatagramSocket.BindServiceNameAsync Método

Definição

Namespace:

Windows.Networking.Sockets

Sobrecargas

Nome	Description
BindServiceNameAsync(String)	Inicia uma operação de associação em uma datagramSocket a um nome de serviço local.
BindServiceNameAsync(String, NetworkAdapter)	Inicia uma operação de associação em uma datagramSocket a um nome de serviço local e a um adaptador de rede específico.

BindServiceNameAsync(String)

Inicia uma operação de associação em uma datagramSocket a um nome de serviço local.

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

Parâmetros

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

Requisitos	Description
Funcionalidades do aplicativo	internetClientServer privateNetworkClientServer

Comentários

O método BindServiceNameAsync associa-se aos endereços IP locais de todos os adaptadores de rede no computador local no nome do serviço local ou na porta UDP especificada no parâmetro localServiceName. 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 BindServiceNameAsync falhará se outro aplicativo usando UDP (outro DatagramSocket, por exemplo) já tiver sido associado à porta UDP local especificada no parâmetro localServiceName.

A associação é essencial para receber dados de qualquer ponto de extremidade remoto em umdatagramSocket e geralmente é 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. Gravar em um fluxo retornado por um dos métodos GetOutputStreamAsync também resultará em uma operação de associação se o soquete ainda não estiver associado.

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

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

BindServiceNameAsync(String, NetworkAdapter)

Inicia uma operação de associação em uma datagramSocket a um nome de serviço local e a um adaptador de rede específico.

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

Parâmetros

localServiceName

String

Platform::String

winrt::hstring

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

adapter

NetworkAdapter

O adaptador de rede no qual associar o objeto DatagramSocket.

Retornos

IAsyncAction

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

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

O método [BindServiceNameAsync(String, NetworkAdapter) associa-se a uma interface de rede especificada no parâmetro do adaptador e o nome do serviço local ou a porta UDP especificada no parâmetro localServiceName do no computador local. Se o parâmetro localServiceName for uma cadeia de caracteres vazia, o sistema selecionará a porta UDP local na qual associar. Se o adaptador parâmetro for nulo, ocorrerá um erro.

O mecanismo de resolução de nomes usado pelo método [BindServiceNameAsync(String, NetworkAdapter) é limitado à interface especificada para o namespace DNS (sistema de nomes de domínio).

A menos que você tenha usado a propriedade DatagramSocketControl.MulticastOnly, o método BindServiceNameAsync falhará se outro aplicativo usando UDP (outro DatagramSocket, por exemplo) já tiver sido associado à porta UDP local especificada no parâmetro localServiceName do na mesma interface de rede.

A associação é essencial para receber dados de qualquer ponto de extremidade remoto em umdatagramSocket e geralmente é 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, mas não podem ser limitados a um adaptador de rede específico. Gravar em um fluxo retornado por um dos métodos GetOutputStreamAsync também resultará em uma operação de associação se o soquete ainda não estiver associado, mas não puder ser limitado a um adaptador de rede específico.

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.

Se o método [BindServiceNameAsync(String, NetworkAdapter) for usado, a operação de associação limitará os pacotes multicast e unicast de entrada e saída ao adaptador especificado.

Usar o adaptador de rede especificado é uma base de melhor esforço. Entre outras configurações, sistemas com adaptadores configurados em modos de host fraco ou de encaminhamento podem usar um adaptador diferente do adaptador especificado.

Confira também

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