Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve de forma asincrónica las direcciones de Protocolo de 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);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
Nombre de host o dirección IP que se va a resolver.
- requestCallback
- AsyncCallback
AsyncCallback Delegado que hace referencia al método que se va a invocar cuando se completa la operación.
- state
- Object
Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al requestCallback delegado cuando se completa la operación.
Devoluciones
Instancia IAsyncResult de que hace referencia a la solicitud asincrónica.
Excepciones
hostNameOrAddress es null.
La longitud de es mayor que hostNameOrAddress 255 caracteres.
Se produce un error al resolver hostNameOrAddress.
hostNameOrAddress es una dirección IP no 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.
Note
Este miembro emite información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .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.
