Dns.GetHostAddressesAsync(String) メソッド

定義

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。Returns the Internet Protocol (IP) addresses for the specified host as an asynchronous operation.

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 アドレス。The host name or IP address to resolve.

戻り値

Task<IPAddress[]>

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation. タスク オブジェクトの Result プロパティは、hostNameOrAddress パラメーターで指定されたホストの IP アドレスを保持する IPAddress 型の配列を返します。The Result property on the task object returns an array of type IPAddress that holds the IP addresses for the host that is specified by the hostNameOrAddress parameter.

例外

hostNameOrAddressnullです。hostNameOrAddress is null.

hostNameOrAddress の長さが 255 文字を超えています。The length of hostNameOrAddress is greater than 255 characters.

hostNameOrAddress を解決するときにエラーが発生しました。An error is encountered when resolving hostNameOrAddress.

hostNameOrAddress は無効な IP アドレスです。hostNameOrAddress is an invalid IP address.

注釈

この操作はブロックされません。This operation will not block. が解決されると、返された Task<TResult> オブジェクトは完了し hostNameOrAddress ます。The returned Task<TResult> object will complete after the hostNameOrAddress has been resolved.

このメソッドは、ホスト名に関連付けられた IP アドレスを DNS サーバーに照会します。This method queries a DNS server for the IP addresses associated with a host name. hostNameOrAddressが IP アドレスの場合は、DNS サーバーにクエリを実行せずにこのアドレスが返されます。If hostNameOrAddress is an IP address, this address is returned without querying the DNS server.

適用対象