Dns.GetHostByName(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.