Dns.GetHostAddresses(String) Metodo

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

Parametri

Valori restituiti

Matrice di tipo IPAddress che contiene gli indirizzi IP per l'host specificato dal hostNameOrAddress parametro .

Eccezioni

Esempio

Nell'esempio di codice seguente viene usato il GetHostAddresses metodo per risolvere un indirizzo IP in una matrice di tipo 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

Commenti

Il GetHostAddresses metodo esegue una query sul sottosistema DNS per gli indirizzi IP associati a un nome host. Se hostNameOrAddress è un indirizzo IP, questo indirizzo viene restituito senza eseguire query sul server DNS.

Se come argomento viene passata hostNameOrAddress una stringa vuota, questo metodo restituisce gli indirizzi IPv4 e IPv6 dell'host locale.

Gli indirizzi IPv6 vengono filtrati dai risultati del GetHostAddresses metodo se il computer locale non ha installato IPv6. Di conseguenza, è possibile recuperare un'istanza vuota IPAddress se per il hostNameOrAddress parametro sono disponibili solo i risultati IPv6.

Questo metodo viene implementato usando le API di risoluzione dei nomi del sistema operativo sottostante , ad esempio getaddrinfo dell'API Win32 in Windows e API equivalenti in altre piattaforme. Se un host è descritto nel hosts file, gli indirizzi IP o gli indirizzi verranno restituiti senza eseguire query sul server DNS.