Dns.GetHostAddresses(String) Methode

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

Parameter

Gibt zurück

Ein Array vom Typ IPAddress , das die IP-Adressen für den Host enthält, der durch den hostNameOrAddress Parameter angegeben wird.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird die GetHostAddresses Methode verwendet, um eine IP-Adresse in ein Array vom Typ IPAddressaufzulösen.

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

Hinweise

Die GetHostAddresses Methode fragt das DNS-Subsystem nach den IP-Adressen ab, die einem Hostnamen zugeordnet sind. Wenn hostNameOrAddress es sich um eine IP-Adresse handelt, wird diese Adresse ohne Abfrage des DNS-Servers zurückgegeben.

Wenn eine leere Zeichenfolge als hostNameOrAddress Argument übergeben wird, gibt diese Methode die IPv4- und IPv6-Adressen des lokalen Hosts zurück.

IPv6-Adressen werden aus den Ergebnissen der GetHostAddresses Methode gefiltert, wenn der lokale Computer IPv6 nicht installiert hat. Daher ist es möglich, eine leere IPAddress Instanz zurückzuholen, wenn nur IPv6-Ergebnisse für den hostNameOrAddress Parameter verfügbar waren.

Diese Methode wird mithilfe der Namensauflösungs-APIs des zugrunde liegenden Betriebssystems implementiert (z. B. win32-API getaddrinfo unter Windows und entsprechende APIs auf anderen Plattformen). Wenn ein Host in der hosts Datei beschrieben wird, werden die IP-Adresse oder Adressen zurückgegeben, ohne den DNS-Server abzufragen.