Dns.GetHostAddressesAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.NameResolution.dll

重载

GetHostAddressesAsync(String, AddressFamily, CancellationToken)	返回指定主机的 Internet 协议 (IP) 地址以作为异步操作。
GetHostAddressesAsync(String, CancellationToken)	返回指定主机的 Internet 协议 (IP) 地址以作为异步操作。
GetHostAddressesAsync(String)	返回指定主机的 Internet 协议 (IP) 地址以作为异步操作。

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Source:

Dns.cs

返回指定主机的 Internet 协议 (IP) 地址以作为异步操作。

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);

static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())

参数

hostNameOrAddress

String

要解析的主机名或 IP 地址。

family

AddressFamily

应检索其 IP 的地址系列。 如果 Unspecified为 ，则检索所有 IP，而不考虑地址系列。

cancellationToken

CancellationToken

应取消可用于指示异步操作的取消令牌。

返回

Task<IPAddress[]>

表示异步操作的任务对象。 任务对象上的 Result 属性返回类型为 IPAddress 的数组，该类型包含 hostNameOrAddress 参数指定的主机的 IP 地址。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 GetHostAddresses(String, AddressFamily)异常。

GetHostAddressesAsync(String, CancellationToken)

Source:

Dns.cs

返回指定主机的 Internet 协议 (IP) 地址以作为异步操作。

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);

static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())

参数

hostNameOrAddress

String

要解析的主机名或 IP 地址。

cancellationToken

CancellationToken

应取消可用于指示异步操作的取消令牌。

返回

Task<IPAddress[]>

表示异步操作的任务对象。 任务对象上的 Result 属性返回类型为 IPAddress 的数组，该类型包含 hostNameOrAddress 参数指定的主机的 IP 地址。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 GetHostAddresses(String)异常。

GetHostAddressesAsync(String)

Source:

Dns.cs

返回指定主机的 Internet 协议 (IP) 地址以作为异步操作。

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress);

static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())

参数

hostNameOrAddress

String

要解析的主机名或 IP 地址。

返回

Task<IPAddress[]>

表示异步操作的任务对象。 任务对象上的 Result 属性返回类型为 IPAddress 的数组，该类型包含 hostNameOrAddress 参数指定的主机的 IP 地址。

例外

ArgumentNullException

hostNameOrAddress 为 null。

ArgumentOutOfRangeException

hostNameOrAddress 的长度超过 255 个字符。

SocketException

解析 hostNameOrAddress 时遇到错误。

ArgumentException

hostNameOrAddress 是无效的 IP 地址。

注解

此操作不会阻止。 解析 后，hostNameOrAddress返回Task<TResult>的对象将完成。

此方法在 DNS 服务器中查询与主机名关联的 IP 地址。 如果 hostNameOrAddress 是 IP 地址，则返回此地址而不查询 DNS 服务器。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 GetHostAddresses(String)异常。