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 方法。

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