Dns.BeginGetHostAddresses(String, AsyncCallback, Object) 方法

定義

命名空間:

System.Net

組件:

System.Net.NameResolution.dll

來源:

Dns.cs

非同步傳回指定之主機的網際網路通訊協定 (IP) 位址。

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);

public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, object? state);

static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult

Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

參數

hostNameOrAddress

String

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

requestCallback

AsyncCallback

AsyncCallback 委派，會於作業完成時參考要叫用的方法。

state

Object

使用者定義物件，包含作業的相關資訊。 作業完成時會將這個物件傳遞至 requestCallback 委派。

傳回

IAsyncResult

參考非同步要求的 IAsyncResult 執行個體。

例外狀況

ArgumentNullException

hostNameOrAddress 為 null。

ArgumentOutOfRangeException

hostNameOrAddress 的長度大於 255 個字元。

SocketException

當解析 hostNameOrAddress 時，發生錯誤。

ArgumentException

hostNameOrAddress 為無效的 IP 位址。

備註

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

注意

當您在應用程式中啟用網路追蹤時，此成員會發出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

如果空字串傳遞為 hostNameOrAddress 自變數，則此方法會傳回本機主機的 IPv4 和 IPv6 位址。

異步 BeginGetHostAddresses 操作必須藉由呼叫 EndGetHostAddresses 方法來完成。 一般而言，委派會叫 requestCallback 用 方法。

在作業完成之前，此方法不會封鎖。 若要封鎖直到作業完成為止，請使用 GetHostAddresses 方法。

如需使用異步程序設計模型的詳細資訊，請參閱 異步呼叫同步方法