Dns.GetHostAddresses Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.NameResolution.dll

Overload

GetHostAddresses(String)	Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato.
GetHostAddresses(String, AddressFamily)	Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato.

GetHostAddresses(String)

Origine:

Dns.cs

Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato.

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

hostNameOrAddress

String

Nome dell'host o indirizzo IP da risolvere.

Restituisce

IPAddress[]

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

Eccezioni

ArgumentNullException

hostNameOrAddress è null.

ArgumentOutOfRangeException

La lunghezza del parametro hostNameOrAddress è maggiore di 255 caratteri.

SocketException

Si è verificato un errore durante la risoluzione del parametro hostNameOrAddress.

ArgumentException

hostNameOrAddress è un indirizzo IP non valido.

Esempio

Nell'esempio di codice seguente viene usato il GetHostAddresses metodo per risolvere un indirizzo IP in una matrice di tipo IPAddress.

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

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 in base ai risultati del GetHostAddresses metodo se nel computer locale non è 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 viene descritto nel hosts file, l'indirizzo IP o gli indirizzi verranno restituiti senza eseguire query sul server DNS.

Nota

Questo membro genera informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

GetHostAddresses(String, AddressFamily)

Origine:

Dns.cs

Restituisce gli indirizzi IP (Internet Protocol) per l'host specificato.

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

Parametri

hostNameOrAddress

String

Nome dell'host o indirizzo IP da risolvere.

family

AddressFamily

Famiglia di indirizzi per cui devono essere recuperati gli indirizzi IP. Se Unspecified, recuperare tutti gli indirizzi IP indipendentemente dalla famiglia di indirizzi.

Restituisce

IPAddress[]

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