Sdílet prostřednictvím


Dns.GetHostAddressesAsync Metoda

Definice

Přetížení

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Vrátí IP adresy pro zadaného hostitele jako asynchronní operaci.

GetHostAddressesAsync(String, CancellationToken)

Vrátí IP adresy pro zadaného hostitele jako asynchronní operaci.

GetHostAddressesAsync(String)

Vrátí IP adresy pro zadaného hostitele jako asynchronní operaci.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Zdroj:
Dns.cs
Zdroj:
Dns.cs
Zdroj:
Dns.cs

Vrátí IP adresy pro zadaného hostitele jako asynchronní operaci.

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())

Parametry

hostNameOrAddress
String

Název hostitele nebo IP adresa, které se mají přeložit.

family
AddressFamily

Rodina adres, pro kterou se mají načíst IP adresy. Pokud Unspecified, načtěte všechny IP adresy bez ohledu na rodinu adres.

cancellationToken
CancellationToken

Token zrušení, který lze použít k signalizaci asynchronní operace, by se měl zrušit.

Návraty

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole typu IPAddress , které obsahuje IP adresy pro hostitele, který je určen parametrem hostNameOrAddress .

Výjimky

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostAddresses(String, AddressFamily).

Platí pro

GetHostAddressesAsync(String, CancellationToken)

Zdroj:
Dns.cs
Zdroj:
Dns.cs
Zdroj:
Dns.cs

Vrátí IP adresy pro zadaného hostitele jako asynchronní operaci.

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())

Parametry

hostNameOrAddress
String

Název hostitele nebo IP adresa, které se mají přeložit.

cancellationToken
CancellationToken

Token zrušení, který lze použít k signalizaci asynchronní operace, by se měl zrušit.

Návraty

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole typu IPAddress , které obsahuje IP adresy pro hostitele, který je určen parametrem hostNameOrAddress .

Výjimky

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostAddresses(String).

Platí pro

GetHostAddressesAsync(String)

Zdroj:
Dns.cs
Zdroj:
Dns.cs
Zdroj:
Dns.cs

Vrátí IP adresy pro zadaného hostitele jako asynchronní operaci.

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())

Parametry

hostNameOrAddress
String

Název hostitele nebo IP adresa, které se mají přeložit.

Návraty

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole typu IPAddress , které obsahuje IP adresy pro hostitele, který je určen parametrem hostNameOrAddress .

Výjimky

hostNameOrAddress je null.

Délka hostNameOrAddress je větší než 255 znaků.

Při řešení chyby dojde k hostNameOrAddresschybě .

hostNameOrAddress je neplatná IP adresa.

Poznámky

Tato operace nebude blokována. Vrácený Task<TResult> objekt se dokončí po vyřešení objektu hostNameOrAddress .

Tato metoda dotazuje server DNS na IP adresy přidružené k názvu hostitele. Pokud hostNameOrAddress se jedná o IP adresu, vrátí se tato adresa bez dotazu na server DNS.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostAddresses(String).

Platí pro