Dns.GetHostAddresses Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.NameResolution.dll

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

Quelle:

Dns.cs

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

IPAddress[]

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

Ausnahmen

ArgumentNullException

hostNameOrAddress ist null.

ArgumentOutOfRangeException

hostNameOrAddress ist länger als 255 Zeichen.

SocketException

Beim Auflösen von hostNameOrAddress ist ein Fehler aufgetreten.

ArgumentException

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 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 auf dem lokalen Computer IPv6 nicht installiert ist. 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. 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. 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 in .NET Framework.

GetHostAddresses(String, AddressFamily)

Quelle:

Dns.cs

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, ruft alle IP-Adressen ab, unabhängig von der Adressfamilie.

Gibt zurück

IPAddress[]

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