Dns.GetHostAddressesAsync(String) 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 gli indirizzi IP (Internet Protocol) per l'host specificato come operazione asincrona.
public:
static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync(string hostNameOrAddress);static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())Parametri
- hostNameOrAddress
- String
Nome host o indirizzo IP da risolvere.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona. La Result proprietà nell'oggetto attività restituisce una matrice di tipo IPAddress che contiene gli indirizzi IP per l'host specificato dal hostNameOrAddress parametro .
Eccezioni
hostNameOrAddress è null.
La lunghezza di hostNameOrAddress è maggiore di 255 caratteri.
Si verifica un errore durante la risoluzione di hostNameOrAddress.
hostNameOrAddress è un indirizzo IP non valido.
Commenti
Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo la risoluzione di hostNameOrAddress .
Questo metodo esegue una query 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.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da GetHostAddresses(String).