Partilhar via


Dns.GetHostByName(String) Método

Definição

Cuidado

GetHostByName has been deprecated. Use GetHostEntry instead.

Cuidado

GetHostByName is obsoleted for this type, please use GetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202

Cuidado

GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202

Obtém as informações de DNS para o nome do host DNS especificado.

public:
 static System::Net::IPHostEntry ^ GetHostByName(System::String ^ hostName);
[System.Obsolete("GetHostByName has been deprecated. Use GetHostEntry instead.")]
public static System.Net.IPHostEntry GetHostByName(string hostName);
[System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Net.IPHostEntry GetHostByName(string hostName);
[System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Net.IPHostEntry GetHostByName(string hostName);
public static System.Net.IPHostEntry GetHostByName(string hostName);
[<System.Obsolete("GetHostByName has been deprecated. Use GetHostEntry instead.")>]
static member GetHostByName : string -> System.Net.IPHostEntry
[<System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")>]
static member GetHostByName : string -> System.Net.IPHostEntry
[<System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")>]
static member GetHostByName : string -> System.Net.IPHostEntry
static member GetHostByName : string -> System.Net.IPHostEntry
Public Shared Function GetHostByName (hostName As String) As IPHostEntry

Parâmetros

hostName
String

O nome DNS do host.

Retornos

Um IPHostEntry objeto que contém informações de host para o endereço especificado em hostName.

Atributos

Exceções

hostName é null.

O comprimento é hostName maior que 255 caracteres.

Um erro é encontrado ao resolver hostName.

Comentários

O GetHostByName método consulta o servidor DNS da Internet para obter informações de host. Se você passar uma cadeia de caracteres vazia como o nome do host, esse método recuperará o nome do host padrão para o computador local.

Para acesso assíncrono às informações de DNS, use os métodos e EndGetHostByName os BeginGetHostByName métodos.

Se a Ipv6Element.Enabled propriedade estiver definida como true, a Aliases propriedade da IPHostEntry instância retornada não será preenchida por esse método e sempre estará vazia.

Observação

Esse membro emite informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

Aplica-se a