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

Parameters

Retouren

Een matrix van het type IPAddress dat de IP-adressen bevat voor de host die is opgegeven door de hostNameOrAddress parameter.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt de GetHostAddresses methode gebruikt om een IP-adres op te lossen in een matrix van het type 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

Opmerkingen

De GetHostAddresses methode voert een query uit op het DNS-subsysteem voor de IP-adressen die zijn gekoppeld aan een hostnaam. Als hostNameOrAddress dit een IP-adres is, wordt dit adres geretourneerd zonder een query uit te voeren op de DNS-server.

Als een lege tekenreeks wordt doorgegeven als het hostNameOrAddress argument, retourneert deze methode de IPv4- en IPv6-adressen van de lokale host.

IPv6-adressen worden gefilterd op basis van de resultaten van de GetHostAddresses methode als op de lokale computer geen IPv6 is geïnstalleerd. Als gevolg hiervan is het mogelijk om een leeg IPAddress exemplaar terug te krijgen als alleen IPv6-resultaten beschikbaar waren voor de hostNameOrAddress parameter.

Deze methode wordt geïmplementeerd met behulp van de naamomzettings-API's van het onderliggende besturingssysteem (zoals de Win32 API getaddrinfo op Windows en equivalente API's op andere platforms). Als een host in het hosts bestand wordt beschreven, worden het IP-adres of de adressen geretourneerd zonder een query uit te voeren op de DNS-server.