Dns.GetHostAddressesAsync Metoda

Definicja

Przestrzeń nazw:: System.Net

Zestawy:: netstandard.dll, System.Net.NameResolution.dll

Zestaw:: System.Net.NameResolution.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Nazwa	Opis
GetHostAddressesAsync(String)	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, AddressFamily, CancellationToken)	Zwraca adresy protokołu internetowego (IP) określonego hosta jako operację asynchroniczną.

GetHostAddressesAsync(String)

Źródło:: Dns.cs

Źródło:: Dns.cs

Ź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

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

Parametr hostNameOrAddress ma wartość null.

ArgumentOutOfRangeException

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

SocketException

Napotkano błąd podczas rozwiązywania problemu hostNameOrAddress.

ArgumentException

hostNameOrAddress jest nieprawidłowym adresem IP.

Uwagi

Ta operacja nie zostanie zablokowana. 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ń względem serwera DNS.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program GetHostAddresses(String).

Dotyczy

GetHostAddressesAsync(String, CancellationToken)

Źródło:: Dns.cs

Źródło:: Dns.cs

Ź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

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

Zwraca

Task<IPAddress[]>

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Dotyczy

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Źródło:: Dns.cs

Źródło:: Dns.cs

Ź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

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

Zwraca

Task<IPAddress[]>

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Dotyczy

Opinia

Czy ta strona była pomocna?