Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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