Dns.GetHostAddressesAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.NameResolution.dll

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

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

Task<IPAddress[]>

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

OperationCanceledException

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

GetHostAddressesAsync(String, CancellationToken)

Ź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

Task<IPAddress[]>

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

OperationCanceledException

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

GetHostAddressesAsync(String)

Ź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

Task<IPAddress[]>

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

ArgumentNullException

hostNameOrAddress to null.

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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