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

Definição

Atenção

BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202

Atenção

BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202

Inicia um pedido assíncrono de IPHostEntry informação sobre o nome do host DNS especificado.

public:
 static IAsyncResult ^ BeginGetHostByName(System::String ^ hostName, AsyncCallback ^ requestCallback, System::Object ^ stateObject);
public static IAsyncResult BeginGetHostByName(string hostName, AsyncCallback requestCallback, object stateObject);
[System.Obsolete("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public static IAsyncResult BeginGetHostByName(string hostName, AsyncCallback requestCallback, object stateObject);
[System.Obsolete("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")]
public static IAsyncResult BeginGetHostByName(string hostName, AsyncCallback requestCallback, object stateObject);
static member BeginGetHostByName : string * AsyncCallback * obj -> IAsyncResult
[<System.Obsolete("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")>]
static member BeginGetHostByName : string * AsyncCallback * obj -> IAsyncResult
[<System.Obsolete("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")>]
static member BeginGetHostByName : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostByName (hostName As String, requestCallback As AsyncCallback, stateObject As Object) As IAsyncResult

Parâmetros

hostName
String

O nome DNS do anfitrião.

requestCallback
AsyncCallback

Um AsyncCallback delegado que faz referência ao método a invocar quando a operação estiver completa.

stateObject
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.

Atributos

Exceções

hostName é null.

Foi encontrado um erro ao executar a consulta DNS.

Observações

A operação assíncrona BeginGetHostByName deve ser concluída chamando o EndGetHostByName 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 GetHostByName método.

Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos.

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.

Aplica-se a

Ver também