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 (Internet Protocol) pro zadaného hostitele jako asynchronní operaci.
GetHostAddressesAsync(String, CancellationToken)	Vrátí ip adresy (Internet Protocol) pro zadaného hostitele jako asynchronní operaci.
GetHostAddressesAsync(String)	Vrátí ip adresy (Internet Protocol) pro zadaného hostitele jako asynchronní operaci.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Zdroj:

Dns.cs

Vrátí ip adresy (Internet Protocol) 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

Řada adres, pro kterou se mají načíst IP adresy. Pokud , Unspecifiednač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 měl být zrušen.

Návraty

Task<IPAddress[]>

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

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává 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 (Internet Protocol) 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 měl být zrušen.

Návraty

Task<IPAddress[]>

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

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává 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 (Internet Protocol) 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 hostitele určeného parametrem hostNameOrAddress .

Výjimky

ArgumentNullException

hostNameOrAddress je null.

ArgumentOutOfRangeException

Délka hostNameOrAddress souboru 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. Task<TResult> Vrácený objekt se dokončí po vyřešení objektu hostNameOrAddress .

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetHostAddresses(String).