Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
De forma assíncrona, retorna os endereços de Protocolo de Internet (IP) 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 -> IAsyncResultPublic Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- hostNameOrAddress
- String
O nome do host ou o endereço IP a resolver.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a operação estiver completa.
- state
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação. Este objeto é passado ao requestCallback delegado quando a operação está concluída.
Devoluções
Uma IAsyncResult instância que faz referência ao pedido assíncrono.
Exceções
hostNameOrAddress é null.
O comprimento de hostNameOrAddress é superior a 255 caracteres.
Encontra-se um erro ao resolver hostNameOrAddress.
hostNameOrAddress é um endereço IP inválido.
Observações
O BeginGetHostAddresses método consulta assíncronamente um servidor DNS para obter os endereços IP associados a um nome de host. Se hostNameOrAddress for um endereço IP, este endereço é devolvido sem consultar o servidor DNS.
Note
Este membro emite informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Rastreamento de Rede no .NET Framework.
Se uma string vazia for passada como hostNameOrAddress argumento, então este método devolve 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.
Este método não bloqueia até que a operação esteja completa. Para bloquear até a operação estar concluída, use o GetHostAddresses método.
Para mais informações sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos
