Dns.GetHostAddresses メソッド

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

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()

パラメーター

返品

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

例外

例

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

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 サブシステムに照会します。 hostNameOrAddressが IP アドレスの場合、このアドレスは DNS サーバーに対してクエリを実行せずに返されます。

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

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

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

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

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()

パラメーター

返品

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