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

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.NameResolution.dll

Source:

Dns.cs

Devuelve, de manera asincrónica, las direcciones del protocolo Internet (IP) para el host especificado.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::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

Nombre de host o dirección IP que se va a resolver.

requestCallback

AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la operación se complete.

state

Object

Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al delegado de requestCallback cuando la operación se completa.

Devoluciones

IAsyncResult

Instancia de IAsyncResult que hace referencia a la solicitud asincrónica.

Excepciones

ArgumentNullException

hostNameOrAddress es null.

ArgumentOutOfRangeException

La longitud de hostNameOrAddress es mayor que 255 caracteres.

SocketException

Se detectó un error al resolver hostNameOrAddress.

ArgumentException

hostNameOrAddress no es una dirección IP válida.

Comentarios

El BeginGetHostAddresses método consulta de forma asincrónica un servidor DNS para las direcciones IP asociadas a un nombre de host. Si hostNameOrAddress es una dirección IP, esta dirección se devuelve sin consultar el servidor DNS.

Nota

Este miembro emite información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Si se pasa una cadena vacía como hostNameOrAddress argumento, este método devuelve las direcciones IPv4 e IPv6 del host local.

La operación asincrónica BeginGetHostAddresses debe completarse llamando al EndGetHostAddresses método . Normalmente, el delegado invoca el requestCallback método .

Este método no se bloquea hasta que se complete la operación. Para bloquear hasta que se complete la operación, use el GetHostAddresses método .

Para obtener más información sobre el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.