Dns.GetHostAddresses Methode

Definition

Überlädt

GetHostAddresses(String)

Gibt die IP-Adressen für den angegebenen Host zurück.

GetHostAddresses(String, AddressFamily)

Gibt die IP-Adressen für den angegebenen Host zurück.

GetHostAddresses(String)

Gibt die IP-Adressen für den angegebenen Host zurück.

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

hostNameOrAddress
String

Der aufzulösende Hostname oder die aufzulösende IP-Adresse.

Gibt zurück

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

Ausnahmen

hostNameOrAddress ist null.

hostNameOrAddress ist länger als 255 Zeichen.

Beim Auflösen von hostNameOrAddress ist ein Fehler aufgetreten.

hostNameOrAddress ist keine gültige IP-Adresse.

Beispiele

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

    // 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

Hinweise

Die GetHostAddresses -Methode fragt das DNS-Subsystem nach den IP-Adressen ab, die einem Hostnamen zugeordnet sind. Wenn hostNameOrAddress eine IP-Adresse ist, 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 auf dem lokalen Computer IPv6 nicht installiert ist. Daher ist es möglich, eine leere IPAddress Instanz zurückzugeben, 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. die Win32-API getaddrinfo unter Windows und entsprechende APIs auf anderen Plattformen). Wenn ein Host in der hosts Datei beschrieben wird, werden die ip-Adresse bzw. die dort angegebenen Adressen zurückgegeben, ohne den DNS-Server abzufragen.

Hinweis

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Gilt für:

GetHostAddresses(String, AddressFamily)

Gibt die IP-Adressen für den angegebenen Host zurück.

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

Parameter

hostNameOrAddress
String

Der aufzulösende Hostname oder die aufzulösende IP-Adresse.

family
AddressFamily

Die Adressfamilie, für die IP-Adressen abgerufen werden sollen. Wenn Unspecified, rufen Sie alle IP-Adressen unabhängig von der Adressfamilie ab.

Gibt zurück

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

Gilt für: