Dns.GetHostAddressesAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.NameResolution.dll

多載

GetHostAddressesAsync(String, AddressFamily, CancellationToken)	以非同步作業的方式，傳回指定之主機的網際網路通訊協定 (IP) 位址。
GetHostAddressesAsync(String, CancellationToken)	以非同步作業的方式，傳回指定之主機的網際網路通訊協定 (IP) 位址。
GetHostAddressesAsync(String)	以非同步作業的方式，傳回指定之主機的網際網路通訊協定 (IP) 位址。

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 的位址系列。 如果 Unspecified 為 ，則擷取所有 IP，而不論位址系列為何。

cancellationToken

CancellationToken

可用來通知應該取消非同步作業的取消權杖。

傳回

Task<IPAddress[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回類型為 IPAddress 的陣列，這個陣列會保存 hostNameOrAddress 參數所指定之主機的 IP 位址。

例外狀況

OperationCanceledException

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException 仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 GetHostAddresses(String, AddressFamily) 例外狀況。

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)

來源:

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) 例外狀況。