共用方式為


Dns.GetHostAddressesAsync 方法

定義

多載

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

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

GetHostAddressesAsync(String, CancellationToken)

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

GetHostAddressesAsync(String)

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

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

來源:
Dns.cs
來源:
Dns.cs
來源:
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

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

傳回

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

例外狀況

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

備註

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

適用於

GetHostAddressesAsync(String, CancellationToken)

來源:
Dns.cs
來源:
Dns.cs
來源:
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

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

傳回

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

例外狀況

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

備註

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

適用於

GetHostAddressesAsync(String)

來源:
Dns.cs
來源:
Dns.cs
來源:
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 位址。

傳回

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

例外狀況

hostNameOrAddressnull

hostNameOrAddress 的長度大於 255 個字元。

當解析 hostNameOrAddress 時,發生錯誤。

hostNameOrAddress 為無效的 IP 位址。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在 解析之後 hostNameOrAddress 完成。

此方法會查詢 DNS 伺服器,以取得與主機名相關聯的 IP 位址。 如果 hostNameOrAddress 是IP位址,則會傳回此位址,而不查詢 DNS 伺服器。

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

適用於