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

定义

命名空间:

System.Net

程序集:

System.Net.NameResolution.dll

Source:

Dns.cs

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

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