Dns.GetHostAddresses Methode

Quelle:

Dns.cs

Quelle:

Dns.cs

Quelle:

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

Parameter

Gibt zurück

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

Ausnahmen

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.

Quelle:

Dns.cs

Quelle:

Dns.cs

Quelle:

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

Parameter

Gibt zurück

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