Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Método

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.NameResolution.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
Dns.cs
Origem:
Dns.cs
Origem:
Dns.cs

Retorna os endereços IP (protocolo IP) de modo assíncrono para o host especificado.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, object? state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback requestCallback, object state);
static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

hostNameOrAddress
String

O nome do host ou endereço IP a ser resolvido.

requestCallback
AsyncCallback

Um delegado AsyncCallback que faz referência ao método a ser invocado quando a operação é concluída.

state
Object

Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o delegado requestCallback quando a operação é concluída.

Retornos

IAsyncResult

Uma instância IAsyncResult que referencia a solicitação assíncrona.

Exceções

ArgumentNullException

hostNameOrAddress é null.

ArgumentOutOfRangeException

O tamanho de hostNameOrAddress é maior que 255 caracteres.

SocketException

Um erro foi encontrado durante a resolução de hostNameOrAddress.

ArgumentException

hostNameOrAddress é um endereço IP inválido.

Comentários

O BeginGetHostAddresses método consulta de forma assíncrona um servidor DNS para os endereços IP associados a um nome de host. Se hostNameOrAddress for um endereço IP, esse endereço será retornado sem consultar o servidor DNS.

Observação

Esse membro emite informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

Se uma cadeia de caracteres vazia for passada como o hostNameOrAddress argumento , esse método retornará os endereços IPv4 e IPv6 do host local.

A operação assíncrona BeginGetHostAddresses deve ser concluída chamando o EndGetHostAddresses método . Normalmente, o método é invocado pelo requestCallback delegado.

Esse método não é bloqueado até que a operação seja concluída. Para bloquear até que a operação seja concluída, use o GetHostAddresses método .

Para obter mais informações sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona

Aplica-se a