GetHostByName Méthode (String)
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Dns.GetHostByName, méthode (String)

 
REMARQUE : cette API est désormais obsolète.

Obtient les données DNS pour le nom d'hôte DNS spécifié.

Espace de noms:   System.Net
Assembly:  System (dans System.dll)

[ObsoleteAttribute("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public static IPHostEntry GetHostByName(
	string hostName
)

Paramètres

hostName

Nom DNS de l'hôte.

Valeur de retour

Type: System.Net.IPHostEntry

Objet IPHostEntry qui contient les données d'hôte pour l'adresse spécifiée dans hostName.

Exception Condition
ArgumentNullException

hostName a la valeur null.

ArgumentOutOfRangeException

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

SocketException

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

La méthode GetHostByName recherche les données relatives à l'hôte sur le serveur DNS Internet.Si vous passez une chaîne vide comme nom d'hôte, cette méthode récupère le nom d'hôte standard de l'ordinateur local.

Utilisez les méthodes BeginGetHostByName et EndGetHostByName pour accéder aux informations DNS en mode asynchrone.

Si la propriété Ipv6Element.Enabled a la valeur true, la propriété Aliases de l'instance IPHostEntry retournée n'est pas remplie par cette méthode et sera toujours vide.

System_CAPS_noteRemarque

Ce membre émet des informations de traçage lorsque vous activez le traçage réseau dans votre application.Pour plus d'informations, consultez Network Tracing in the .NET Framework.

L'exemple suivant utilise la méthode GetHostByName pour obtenir les données DNS pour le nom d'hôte DNS spécifié.

    try 
    {
       IPHostEntry hostInfo = Dns.GetHostByName(hostName);
       // Get the IP address list that resolves to the host names contained in the 
       // Alias property.
       IPAddress[] address = hostInfo.AddressList;
       // Get the alias names of the addresses in the IP address list.
       String[] alias = hostInfo.Aliases;

       Console.WriteLine("Host name : " + hostInfo.HostName);
       Console.WriteLine("\nAliases : ");
       for(int index=0; index < alias.Length; index++) {
         Console.WriteLine(alias[index]);
       } 
       Console.WriteLine("\nIP address list : ");
       for(int index=0; index < address.Length; index++) {
          Console.WriteLine(address[index]);
       }
    }
    catch(SocketException e) 
    {
       Console.WriteLine("SocketException caught!!!");
       Console.WriteLine("Source : " + e.Source);
       Console.WriteLine("Message : " + e.Message);
    }
    catch(ArgumentNullException e)
    {
Console.WriteLine("ArgumentNullException caught!!!");
       Console.WriteLine("Source : " + e.Source);
       Console.WriteLine("Message : " + e.Message);
    }
 catch(Exception e)
 {
  Console.WriteLine("Exception caught!!!");
  Console.WriteLine("Source : " + e.Source);
  Console.WriteLine("Message : " + e.Message);
 }

DnsPermission

pour l'accès aux informations DNS.Énumération associée : PermissionState.Unrestricted

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher:
© 2016 Microsoft