Dns.GetHostAddressesAsync 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.
Overload
| Nome | Descrizione |
|---|---|
| GetHostAddressesAsync(String, AddressFamily, CancellationToken) |
Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato come operazione asincrona. |
| GetHostAddressesAsync(String, CancellationToken) |
Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato come operazione asincrona. |
| GetHostAddressesAsync(String) |
Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato come operazione asincrona. |
GetHostAddressesAsync(String, AddressFamily, CancellationToken)
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato come operazione asincrona.
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync(string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())Parametri
- hostNameOrAddress
- String
Nome host o indirizzo IP da risolvere.
- family
- AddressFamily
Famiglia di indirizzi per cui recuperare gli indirizzi IP. Se Unspecified, recuperare tutti gli indirizzi IP indipendentemente dalla famiglia di indirizzi.
- cancellationToken
- CancellationToken
Token di annullamento che può essere usato per segnalare che l'operazione asincrona deve essere annullata.
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
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
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, AddressFamily).
Si applica a
GetHostAddressesAsync(String, CancellationToken)
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
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, System::Threading::CancellationToken cancellationToken);public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync(string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())Parametri
- hostNameOrAddress
- String
Nome host o indirizzo IP da risolvere.
- cancellationToken
- CancellationToken
Token di annullamento che può essere usato per segnalare che l'operazione asincrona deve essere annullata.
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
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
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).
Si applica a
GetHostAddressesAsync(String)
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
- Origine:
- Dns.cs
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).
