Dns.GetHostByName(String) Método

Definição

Atenção

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

Atenção

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

Obtém a informação DNS do nome de host DNS especificado.

public:
 static System::Net::IPHostEntry ^ GetHostByName(System::String ^ hostName);
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);
[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);
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
[<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
Public Shared Function GetHostByName (hostName As String) As IPHostEntry

Parâmetros

hostName
String

O nome DNS do anfitrião.

Devoluções

Um IPHostEntry objeto que contém informação do hospedeiro para o endereço especificado em hostName.

Atributos

Exceções

hostName é null.

O comprimento de hostName é superior a 255 caracteres.

Encontra-se um erro ao resolver hostName.

Observações

O GetHostByName método consulta o servidor DNS da Internet para obter informações do anfitrião. Se passar uma cadeia vazia como nome do anfitrião, este método recupera o nome padrão do computador local.

Para acesso assíncrono à informação DNS, utilize os BeginGetHostByName métodos e.EndGetHostByName

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

Note

Este membro emite informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Network Tracing in .NET Framework.

Aplica-se a