Dns.GetHostAddresses メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Dns.GetHostAddresses メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したホストのインターネットプロトコル (IP: Internet Protocol) アドレスを返します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetHostAddresses
 ( _
    hostNameOrAddress As String _
) As IPAddress()

Visual Basic (使用法)

Dim hostNameOrAddress As String
Dim returnValue As IPAddress()

returnValue = Dns.GetHostAddresses(hostNameOrAddress)

public static IPAddress[] GetHostAddresses
 (
    string hostNameOrAddress
)

C++

public:
static array<IPAddress^>^ GetHostAddresses (
    String^ hostNameOrAddress
)

public static IPAddress[] GetHostAddresses
 (
    String hostNameOrAddress
)

JScript

public static function GetHostAddresses
 (
    hostNameOrAddress : String
) : IPAddress[]

パラメータ

hostNameOrAddress: 解決するホスト名または IP アドレス。

戻り値
hostNameOrAddress パラメータで指定されたホストの IP アドレスを保持する IPAddress 型の配列。

例外

例外の種類	条件
ArgumentNullException	hostNameOrAddress が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	hostNameOrAddress の長さが 126 文字を超えています。
SocketException	hostNameOrAddress を解決するときにエラーが発生しました。
ArgumentException	hostNameOrAddress は無効な IP アドレスです。

解説

GetHostAddresses メソッドは、DNS サーバーでホスト名と関連付けられた IP アドレスを照会します。hostNameOrAddress が IP アドレスである場合、DNS サーバーを照会せずに、このアドレスが返されます。

Windows Server 2003 以外のオペレーティングシステムの場合、ホスト名として空の文字列が渡されると、このメソッドはローカルホストの IPv4 アドレスを返します。Windows Server 2003 の場合、ローカルホストの IPv4 アドレスおよび IPv6 アドレスが返されます。

メモ
このメンバは、アプリケーションでネットワークトレースを有効にしている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

GetHostAddresses メソッドを使用して、IP アドレスを IPAddress 型の配列に解決するコード例を次に示します。

public static void DoGetHostAddresses(string
 hostname)
{
    IPAddress[] ips;

    ips = Dns.GetHostAddresses(hostname);

    Console.WriteLine("GetHostAddresses({0}) returns:", hostname);

    foreach (IPAddress ip in ips)
    {
        Console.WriteLine("    {0}", ip);
    }
}