Dns.GetHostAddressesAsync Metoda

Definicja

Przeciążenia

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

GetHostAddressesAsync(String, CancellationToken)

Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

GetHostAddressesAsync(String)

Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Źródło:
Dns.cs
Źródło:
Dns.cs
Źródło:
Dns.cs

Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

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

Nazwa hosta lub adres IP do rozpoznania.

family
AddressFamily

Rodzina adresów, dla której należy pobrać adresy IP. Jeśli Unspecified, pobierz wszystkie adresy IP niezależnie od rodziny adresów.

cancellationToken
CancellationToken

Należy anulować token anulowania, który może służyć do sygnalizowania operacji asynchronicznej.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę typu IPAddress , która przechowuje adresy IP hosta określonego hostNameOrAddress przez parametr .

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez GetHostAddresses(String, AddressFamily)usługę .

Dotyczy

GetHostAddressesAsync(String, CancellationToken)

Źródło:
Dns.cs
Źródło:
Dns.cs
Źródło:
Dns.cs

Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

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

Nazwa hosta lub adres IP do rozpoznania.

cancellationToken
CancellationToken

Należy anulować token anulowania, który może służyć do sygnalizowania operacji asynchronicznej.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę typu IPAddress , która przechowuje adresy IP hosta określonego hostNameOrAddress przez parametr .

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez GetHostAddresses(String)usługę .

Dotyczy

GetHostAddressesAsync(String)

Źródło:
Dns.cs
Źródło:
Dns.cs
Źródło:
Dns.cs

Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

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

Nazwa hosta lub adres IP do rozpoznania.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę typu IPAddress , która przechowuje adresy IP hosta określonego hostNameOrAddress przez parametr .

Wyjątki

hostNameOrAddress to null.

Długość jest hostNameOrAddress większa niż 255 znaków.

Podczas rozwiązywania problemu hostNameOrAddresswystępuje błąd .

hostNameOrAddress jest nieprawidłowym adresem IP.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po rozwiązaniu problemu hostNameOrAddress .

Ta metoda wysyła zapytanie do serwera DNS dla adresów IP skojarzonych z nazwą hosta. Jeśli hostNameOrAddress jest to adres IP, ten adres jest zwracany bez wykonywania zapytań dotyczących serwera DNS.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez GetHostAddresses(String)usługę .

Dotyczy