Compartilhar via


HostName(String) Construtor

Definição

Cria um novo objeto HostName de uma cadeia de caracteres que contém um nome de host ou um endereço IP.

public:
 HostName(Platform::String ^ hostName);
 HostName(winrt::hstring const& hostName);
public HostName(string hostName);
function HostName(hostName)
Public Sub New (hostName As String)

Parâmetros

hostName
String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém um nome de host ou um endereço IP.

Comentários

Esse construtor cria um novo objeto HostName . O parâmetro hostName pode conter um nome de host ou um endereço IP. Um objeto HostName pode ser usado para um nome de host local ou um nome de host remoto.

O parâmetro hostName pode conter um dos seguintes:

  • O nome de um host que pode ser resolvido pelo DNS (Sistema de Nomes de Domínio) ou por outro provedor de namespace.
  • O nome de um host que corresponde a uma cadeia de caracteres no seguinte arquivo no computador local: %WINDIR%\system32\drivers\etc\hosts
  • Uma cadeia de caracteres que contém um endereço de rede IPv4 ou IPv6 do host. Uma cadeia de caracteres de endereço IPv4 está na notação dotted-decimal ("192.168.1.111", por exemplo). Um endereço IPv6 está na notação hexadecimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", por exemplo). Se o parâmetro hostName for a cadeia de caracteres "localhost", isso representará todos os endereços de loopback no computador local.

O método NetworkInformation.GetHostNames no namespace Windows.Networking.Connectivity pode ser usado para recuperar uma lista de nomes de host ou endereços IP associados ao computador local. Um desses nomes de host ou endereços IP pode ser usado para o parâmetro hostName .

O construtor falhará se o parâmetro hostName for nulo ou contiver uma cadeia de caracteres vazia.

Aplica-se a

Confira também