Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Dns.GetHostByName (Método) (String)

 
Nota: esta API está ahora obsoleta.

Obtiene la información de DNS para el nombre de host DNS especificado.

Espacio de nombres:   System.Net
Ensamblado:  System (en 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
)

Parámetros

hostName

Nombre DNS del host.

Valor devuelto

Type: System.Net.IPHostEntry

Objeto IPHostEntry que contiene información de host para la dirección especificada en hostName.

Exception Condition
ArgumentNullException

hostName es null.

ArgumentOutOfRangeException

La longitud de hostName es mayor que 255 caracteres.

SocketException

Se detectó un error al resolver hostName.

El método GetHostByName consulta el servidor DNS de Internet para obtener información de host.Si se pasa una cadena vacía como nombre de host, este método recupera el nombre de host estándar para el equipo local.

Para obtener acceso asincrónico a información de DNS, utilice los métodos BeginGetHostByName y EndGetHostByName.

Si la propiedad Ipv6Element.Enabled se establece en true, la propiedad Aliases de la instancia IPHostEntry devuelta no la rellena este método y estará siempre vacía.

System_CAPS_noteNota

Este miembro envía información de traza cuando se habilita la traza de la red en la aplicación.Para obtener más información, vea Trasování sítě v rozhraní .NET Framework.

En el ejemplo siguiente se usa el método GetHostByName para obtener la información DNS del nombre de host DNS especificado.

    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

para obtener acceso a la información de DNS.Enumeración asociada: PermissionState.Unrestricted

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: