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

Definição

Namespace:

System.Net

Assembly:

System.Net.NameResolution.dll

Origem:

Dns.cs

Cuidado

BeginGetHostByName has been deprecated. Use BeginGetHostEntry instead.

Inicia uma solicitação assíncrona para a informações IPHostEntry sobre o nome de host DNS especificado.

public:
 static IAsyncResult ^ BeginGetHostByName(System::String ^ hostName, AsyncCallback ^ requestCallback, System::Object ^ stateObject);

[System.Obsolete("BeginGetHostByName has been deprecated. Use BeginGetHostEntry instead.")]
public static IAsyncResult BeginGetHostByName (string hostName, AsyncCallback? requestCallback, object? stateObject);

[<System.Obsolete("BeginGetHostByName has been deprecated. Use BeginGetHostEntry instead.")>]
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 host.

requestCallback

AsyncCallback

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

stateObject

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.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

hostName é null.

SocketException

Foi encontrado um erro ao executar a consulta DNS.

Comentários

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

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

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.

Confira também

• Visão geral da programação assíncrona