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 una stringa vuota viene passata come hostNameOrAddress argomento, 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 tornare a un'istanza vuota IPAddress se sono disponibili solo i risultati IPv6 per il hostNameOrAddress parametro.

Questo metodo viene implementato usando le API di risoluzione dei nomi del sistema operativo sottostanti, ad esempio l'API Win32 getaddrinfo in Windows e le API equivalenti in altre piattaforme. Se un host è descritto nel file, verrà restituito l'indirizzo hosts IP o gli indirizzi 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 è necessario recuperare 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.