Dns.BeginGetHostAddresses(String, AsyncCallback, Object) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
非同步回傳指定主機的網際網路協定（IP）位址。
public:
static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);public static IAsyncResult BeginGetHostAddresses(string hostNameOrAddress, AsyncCallback? requestCallback, object? state);public static IAsyncResult BeginGetHostAddresses(string hostNameOrAddress, AsyncCallback requestCallback, object state);static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResultPublic Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult參數
- hostNameOrAddress
- String
要解析主機名稱或 IP 位址。
- requestCallback
- AsyncCallback
一個 AsyncCallback 代理，當操作完成時會參考呼叫的方法。
- state
- Object
一個包含操作資訊的使用者定義物件。 當操作完成時，這個物件會傳給 requestCallback 代理。
傳回
一個 IAsyncResult 引用非同步請求的實例。
例外狀況
hostNameOrAddress 是 null。
長度 hostNameOrAddress 超過 255 個字元。
當解析 hostNameOrAddress時會遇到錯誤。
hostNameOrAddress 是一個無效的 IP 位址。
備註
此 BeginGetHostAddresses 方法非同步查詢與主機名稱相關的 IP 位址。 如果 hostNameOrAddress 是 IP 位址，則會回傳此位址而不需查詢 DNS 伺服器。
Note
當您在應用程式中啟用網路追蹤時，該成員會發出追蹤資訊。 欲了解更多資訊，請參閱.NET框架中的網絡追蹤。
若參數傳遞 hostNameOrAddress 空字串，則回傳本地主機的 IPv4 與 IPv6 位址。
非同步 BeginGetHostAddresses 操作必須透過呼叫該 EndGetHostAddresses 方法來完成。 通常，該方法由 requestCallback 委託人執行。
此方法在操作完成前不會阻塞。 要阻擋直到操作完成，請使用該 GetHostAddresses 方法。
欲了解更多關於非同步程式設計模型的使用資訊，請參閱 「非同步呼叫同步方法」
