Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metodo

Definizione

Restituisce in modo asincrono gli indirizzi IP (Internet Protocol) per l'host specificato.

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 -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parametri

hostNameOrAddress
String

Nome dell'host o indirizzo IP da risolvere.

requestCallback
AsyncCallback

Delegato AsyncCallback cui fa riferimento il metodo da richiamare al completamento dell'operazione.

state
Object

Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al delegato requestCallback al completamento dell'operazione.

Restituisce

Istanza di IAsyncResult che fa riferimento alla richiesta asincrona.

Eccezioni

hostNameOrAddress è null.

La lunghezza del parametro hostNameOrAddress è maggiore di 255 caratteri.

Si è verificato un errore durante la risoluzione del parametro hostNameOrAddress.

hostNameOrAddress è un indirizzo IP non valido.

Commenti

Il BeginGetHostAddresses metodo esegue una query asincrona su un server DNS per gli indirizzi IP associati a un nome host. Se hostNameOrAddress è un indirizzo IP, questo indirizzo viene restituito senza eseguire query sul server DNS.

Nota

Questo membro genera informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Se come argomento viene passata hostNameOrAddress una stringa vuota, questo metodo restituisce gli indirizzi IPv4 e IPv6 dell'host locale.

L'operazione asincrona BeginGetHostAddresses deve essere completata chiamando il EndGetHostAddresses metodo . In genere, il metodo viene richiamato dal requestCallback delegato.

Questo metodo non viene bloccato fino al completamento dell'operazione. Per bloccare fino al completamento dell'operazione, usare il GetHostAddresses metodo .

Per altre informazioni sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni

Si applica a