Dns.GetHostAddresses 方法

來源:

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 陣列，儲存由 hostNameOrAddress 參數指定的主機的 IP 位址。

來源:

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 陣列，儲存由 hostNameOrAddress 參數指定的主機的 IP 位址。

例外狀況

範例

以下程式碼範例使用該 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 方法會向 DNS 子系統查詢與主機名稱相關的 IP 位址。 如果 hostNameOrAddress 是 IP 位址，則會回傳此位址而不需查詢 DNS 伺服器。

若參數傳遞 hostNameOrAddress 空字串，則回傳本地主機的 IPv4 與 IPv6 位址。

如果本地電腦未安裝 IPv6，則 IPv6 位址會從方法結果 GetHostAddresses 中被過濾掉。 因此，若參數僅有 IPv6 結果，IPAddress則有可能回傳空hostNameOrAddress實例。

此方法透過底層作業系統的名稱解析 API（例如 Windows 上的 Win32 API getaddrinfo，以及其他平台上的等效 API）來實作。 若檔案中描述 hosts 了主機，該 IP 位址會在不查詢 DNS 伺服器的情況下被回傳。