Dns.GetHostAddressesAsync 方法

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.NameResolution.dll

多載

名稱	Description
GetHostAddressesAsync(String)	以非同步操作方式回傳指定主機的網際網路協定（IP）位址。
GetHostAddressesAsync(String, CancellationToken)	以非同步操作方式回傳指定主機的網際網路協定（IP）位址。
GetHostAddressesAsync(String, AddressFamily, CancellationToken)	以非同步操作方式回傳指定主機的網際網路協定（IP）位址。

GetHostAddressesAsync(String)

來源:

Dns.cs

以非同步操作方式回傳指定主機的網際網路協定（IP）位址。

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())

參數

hostNameOrAddress

String

要解析主機名稱或 IP 位址。

傳回

Task<IPAddress[]>

表示異步操作的工作物件。 任務物件上的 Result 屬性會回傳一個型別 IPAddress 為 的陣列，該陣列包含由 hostNameOrAddress 參數指定的主機的 IP 位址。

例外狀況

ArgumentNullException

hostNameOrAddress 是 null。

ArgumentOutOfRangeException

長度 hostNameOrAddress 超過 255 個字元。

SocketException

當解析 hostNameOrAddress時會遇到錯誤。

ArgumentException

hostNameOrAddress 是一個無效的 IP 位址。

備註

這個行動不會被阻擋。 回傳 Task<TResult> 的物件會在解決後完成 hostNameOrAddress 。

此方法會向 DNS 伺服器查詢與主機名稱相關的 IP 位址。 如果 hostNameOrAddress 是 IP 位址，則會回傳此位址而不需查詢 DNS 伺服器。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 GetHostAddresses(String)拋出的例外。

GetHostAddressesAsync(String, CancellationToken)

來源:

Dns.cs

以非同步操作方式回傳指定主機的網際網路協定（IP）位址。

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())

參數

hostNameOrAddress

String

要解析主機名稱或 IP 位址。

cancellationToken

CancellationToken

一個可用來表示非同步操作的消除標記應該被取消。

傳回

Task<IPAddress[]>

表示異步操作的工作物件。 任務物件上的 Result 屬性會回傳一個型別 IPAddress 為 的陣列，該陣列包含由 hostNameOrAddress 參數指定的主機的 IP 位址。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 GetHostAddresses(String)拋出的例外。

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

來源:

Dns.cs

以非同步操作方式回傳指定主機的網際網路協定（IP）位址。

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())

參數

hostNameOrAddress

String

要解析主機名稱或 IP 位址。

family

AddressFamily

應該取得哪些IP的IP地址家族。 若 Unspecified，則擷取所有 IP，不論位址家族為何。

cancellationToken

CancellationToken

一個可用來表示非同步操作的消除標記應該被取消。

傳回

Task<IPAddress[]>

表示異步操作的工作物件。 任務物件上的 Result 屬性會回傳一個型別 IPAddress 為 的陣列，該陣列包含由 hostNameOrAddress 參數指定的主機的 IP 位址。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 GetHostAddresses(String, AddressFamily)拋出的例外。