Dns.GetHostAddressesAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.NameResolution.dll

Přetížení

Name	Description
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

Ř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 se měl zrušit.

Návraty

Task<IPAddress[]>

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

Výjimky

OperationCanceledException

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

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané 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 úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole typu IPAddress , který obsahuje IP adresy hostitele, který je určen parametrem hostNameOrAddress .

Výjimky

OperationCanceledException

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

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané 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 úkolu představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí pole typu IPAddress , který obsahuje IP adresy 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í hostNameOrAddressdošlo k chybě .

ArgumentException

hostNameOrAddress je neplatná IP adresa.

Poznámky

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

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 dotazování na server DNS.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané GetHostAddresses(String).