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

定义

异步返回指定主机的 Internet 协议 (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 -> 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 实例。

例外

hostNameOrAddressnull

hostNameOrAddress 的长度超过 255 个字符。

解析 hostNameOrAddress 时遇到错误。

hostNameOrAddress 是无效的 IP 地址。

注解

方法 BeginGetHostAddresses 异步查询 DNS 服务器,查找与主机名关联的 IP 地址。 如果 hostNameOrAddress 是 IP 地址,则返回此地址而不查询 DNS 服务器。

注意

在应用程序中启用网络跟踪时,此成员发出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪

如果空字符串作为 hostNameOrAddress 参数传递,则此方法返回本地主机的 IPv4 和 IPv6 地址。

BeginGetHostAddresses异步操作必须通过调用 EndGetHostAddresses 方法完成。 通常,委托调用 requestCallback 方法。

在操作完成之前,此方法不会阻止。 若要阻止操作完成,请使用 GetHostAddresses 方法。

有关使用异步编程模型的详细信息,请参阅 异步调用同步方法

适用于