Dns.GetHostAddressesAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.NameResolution.dll

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

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

Task<IPAddress[]>

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

OperationCanceledException

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

GetHostAddressesAsync(String, CancellationToken)

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

Task<IPAddress[]>

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

OperationCanceledException

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

GetHostAddressesAsync(String)

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

Task<IPAddress[]>

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

ArgumentNullException

hostNameOrAddress je null.

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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