Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metodo

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

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);
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 host o indirizzo IP da risolvere.

requestCallback
AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'operazione.

state
Object

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

Valori restituiti

IAsyncResult

IAsyncResult Istanza che fa riferimento alla richiesta asincrona.

Eccezioni

ArgumentNullException

hostNameOrAddress è null.

ArgumentOutOfRangeException

La lunghezza di hostNameOrAddress è maggiore di 255 caratteri.

SocketException

Si verifica un errore durante la risoluzione di hostNameOrAddress.

ArgumentException

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.

Note

Questo membro genera informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .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