GetHostByName Metodo (String)
Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Dns.GetHostByName (String)

 
NOTA: l'API è ora obsoleta.

Ottiene le informazioni DNS per il nome host DNS specificato.

Spazio dei nomi:   System.Net
Assembly:  System (in 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
)

Parametri

hostName

Nome DNS dell'host.

Valore restituito

Type: System.Net.IPHostEntry

Oggetto IPHostEntry contenente informazioni sull'host per l'indirizzo specificato nel parametro hostName.

Exception Condition
ArgumentNullException

hostName è null.

ArgumentOutOfRangeException

La lunghezza del parametro hostName è maggiore di 255 caratteri.

SocketException

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

Il metodo GetHostByName esegue una query nel server DNS Internet per ottenere informazioni sull'host.Se si passa una stringa vuota come nome host, questo metodo recupera il nome host standard per il computer locale.

Per l'accesso asincrono alle informazioni DNS, utilizzare i metodi BeginGetHostByName e EndGetHostByName.

Se la proprietà Ipv6Element.Enabled è impostata su true, la proprietà Aliases dell'istanza IPHostEntry restituita non verrà popolata da questo metodo e sarà sempre vuota.

System_CAPS_noteNota

Questo membro crea informazioni di traccia quando si abilita la tracciatura della rete nell'applicazione.Per ulteriori informazioni, vedere Tracciatura di rete in .NET Framework.

Nell'esempio riportato di seguito viene utilizzato il metodo GetHostByName per ottenere le informazioni DNS per il nome host DNS specificato.

    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

per l'accesso alle informazioni DNS.Enumerazione associata: PermissionState.Unrestricted

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra:
© 2016 Microsoft