Dns.GetHostAddresses Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.NameResolution.dll

Surcharges

GetHostAddresses(String)	Retourne les adresses IP de l'hôte spécifié.
GetHostAddresses(String, AddressFamily)	Retourne les adresses IP de l'hôte spécifié.

GetHostAddresses(String)

Source:

Dns.cs

Retourne les adresses IP de l'hôte spécifié.

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

Paramètres

hostNameOrAddress

String

Nom de l'hôte ou adresse IP à résoudre.

Retours

IPAddress[]

Tableau de type IPAddress qui contient les adresses IP de l'hôte spécifié par le paramètre hostNameOrAddress.

Exceptions

ArgumentNullException

hostNameOrAddress a la valeur null.

ArgumentOutOfRangeException

La longueur de hostNameOrAddress est supérieure à 255 caractères.

SocketException

Une erreur s'est produite lors de la résolution de hostNameOrAddress.

ArgumentException

hostNameOrAddress est une adresse IP non valide.

Exemples

L’exemple de code suivant utilise la GetHostAddresses méthode pour résoudre une adresse IP en tableau de type 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

Remarques

La GetHostAddresses méthode interroge le sous-système DNS pour les adresses IP associées à un nom d’hôte. Si hostNameOrAddress est une adresse IP, cette adresse est retournée sans interroger le serveur DNS.

Si une chaîne vide est passée en tant qu’argument hostNameOrAddress , cette méthode retourne les adresses IPv4 et IPv6 de l’hôte local.

Les adresses IPv6 sont filtrées à partir des résultats de la GetHostAddresses méthode si IPv6 n’est pas installé sur l’ordinateur local. Par conséquent, il est possible de récupérer une instance vide IPAddress si seuls les résultats IPv6 étaient disponibles pour le hostNameOrAddress paramètre .

Cette méthode est implémentée à l’aide des API de résolution de noms du système d’exploitation sous-jacent (telles que l’API Win32 getaddrinfo sur Windows et les API équivalentes sur d’autres plateformes). Si un hôte est décrit dans le hosts fichier, la ou les adresses IP qu’il contient sont retournées sans interroger le serveur DNS.

Remarque

Ce membre émet des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans le .NET Framework.

GetHostAddresses(String, AddressFamily)

Source:

Dns.cs

Retourne les adresses IP de l'hôte spécifié.

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

Paramètres

hostNameOrAddress

String

Nom de l'hôte ou adresse IP à résoudre.

family

AddressFamily

Famille d’adresses pour laquelle les adresses IP doivent être récupérées. Si la valeur est Unspecified, récupérez toutes les adresses IP, quelle que soit la famille d’adresses.

Retours

IPAddress[]

Tableau de type IPAddress qui contient les adresses IP de l'hôte spécifié par le paramètre hostNameOrAddress.