Dns.GetHostAddresses メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.NameResolution.dll

オーバーロード

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

GetHostAddresses(String)

ソース:

Dns.cs

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

public:
 static cli::array <System::Net::IPAddress ^> ^ GetHostAddresses(System::String ^ hostNameOrAddress);

public static System.Net.IPAddress[] GetHostAddresses (string hostNameOrAddress);

static member GetHostAddresses : string -> System.Net.IPAddress[]

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

パラメーター

hostNameOrAddress

String

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

戻り値

IPAddress[]

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

例外

ArgumentNullException

hostNameOrAddress が nullです。

ArgumentOutOfRangeException

hostNameOrAddress の長さが 255 文字を超えています。

SocketException

hostNameOrAddress を解決するときにエラーが発生しました。

ArgumentException

hostNameOrAddress は無効な IP アドレスです。

例

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

    // Determine the Internet Protocol(IP) addresses for a host.
public:
    static void DoGetHostAddress(String^ hostname)
    {
        array<IPAddress^>^ addresses;
        addresses = Dns::GetHostAddresses(hostname);

        Console::WriteLine("GetHostAddresses({0}) returns:", hostname);
        for each (IPAddress^ address in addresses)
        {
            Console::Write("{0} ", address);
        }
        Console::WriteLine("");
   }

public static void DoGetHostAddresses(string hostname)
{
    IPAddress[] addresses = Dns.GetHostAddresses(hostname);

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

    foreach (IPAddress address in addresses)
    {
        Console.WriteLine($"    {address}");
    }
}

Public Sub DoGetHostAddresses(hostName As String)

    Dim addresses As IPAddress() = Dns.GetHostAddresses(hostname)

    Console.WriteLine($"GetHostAddresses({hostname}) returns:")

    Dim index As Integer
    For index = 0 To addresses.Length - 1
        Console.WriteLine($"    {addresses(index)}")
    Next index

End Sub

注釈

メソッドは GetHostAddresses 、ホスト名に関連付けられている IP アドレスについて DNS サブシステムに対してクエリを実行します。 が IP アドレスの場合 hostNameOrAddress 、このアドレスは DNS サーバーに対してクエリを実行せずに返されます。

空の文字列が引数として hostNameOrAddress 渡された場合、このメソッドはローカル ホストの IPv4 アドレスと IPv6 アドレスを返します。

ローカル コンピューターに IPv6 がインストールされていない場合、IPv6 アドレスは メソッドの GetHostAddresses 結果からフィルター処理されます。 その結果、 パラメーターで IPv6 結果のみを使用できた場合は、空 IPAddress のインスタンスを hostNameOrAddress 取得できます。

このメソッドは、基になるオペレーティング システムの名前解決 API (Windows の Win32 API getaddrinfo、他のプラットフォームの同等の API など) を使用して実装されます。 ファイルに hosts ホストが記述されている場合、DNS サーバーに対してクエリを実行せずに、そこに存在する IP アドレスが返されます。

注意

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

GetHostAddresses(String, AddressFamily)

ソース:

Dns.cs

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

public:
 static cli::array <System::Net::IPAddress ^> ^ GetHostAddresses(System::String ^ hostNameOrAddress, System::Net::Sockets::AddressFamily family);

public static System.Net.IPAddress[] GetHostAddresses (string hostNameOrAddress, System.Net.Sockets.AddressFamily family);

static member GetHostAddresses : string * System.Net.Sockets.AddressFamily -> System.Net.IPAddress[]

Public Shared Function GetHostAddresses (hostNameOrAddress As String, family As AddressFamily) As IPAddress()

パラメーター

hostNameOrAddress

String

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

family

AddressFamily

IP を取得する必要があるアドレス ファミリ。 の場合 Unspecifiedは、アドレス ファミリに関係なくすべての IP を取得します。

戻り値

IPAddress[]

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