Dns.GetHostAddressesAsync 方法

定义

重载

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

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

GetHostAddressesAsync(String, CancellationToken)

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

GetHostAddressesAsync(String)

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

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Source:
Dns.cs
Source:
Dns.cs
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

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

返回

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

例外

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

注解

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

适用于

GetHostAddressesAsync(String, CancellationToken)

Source:
Dns.cs
Source:
Dns.cs
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

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

返回

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

例外

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

注解

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

适用于

GetHostAddressesAsync(String)

Source:
Dns.cs
Source:
Dns.cs
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 地址。

返回

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

例外

hostNameOrAddressnull

hostNameOrAddress 的长度超过 255 个字符。

解析 hostNameOrAddress 时遇到错误。

hostNameOrAddress 是无效的 IP 地址。

注解

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

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

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

适用于