Partager via


HostName(String) Constructeur

Définition

Crée un objet HostName à partir d’une chaîne qui contient un nom d’hôte ou une adresse IP.

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

Paramètres

hostName
String

Platform::String

winrt::hstring

Chaîne qui contient un nom d’hôte ou une adresse IP.

Remarques

Ce constructeur crée un objet HostName . Le paramètre hostName peut contenir un nom d’hôte ou une adresse IP. Un objet HostName peut être utilisé pour un nom d’hôte local ou un nom d’hôte distant.

Le paramètre hostName peut contenir l’un des éléments suivants :

  • Nom d’un hôte qui peut être résolu par le DNS (Domain Name System) ou par un autre fournisseur d’espace de noms.
  • Nom d’un hôte qui correspond à une chaîne dans le fichier suivant sur l’ordinateur local : %WINDIR%\system32\drivers\etc\hosts
  • Chaîne qui contient une adresse réseau IPv4 ou IPv6 de l’hôte. Une chaîne d’adresse IPv4 est en notation décimale en pointillés (« 192.168.1.111 », par exemple). Une adresse IPv6 est en notation hexadécimale (« 21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A », par exemple). Si le paramètre hostName est la chaîne « localhost », cela représente toutes les adresses de bouclage sur l’ordinateur local.

La méthode NetworkInformation.GetHostNames de l’espace de noms Windows.Networking.Connectivity peut être utilisée pour récupérer une liste de noms d’hôtes ou d’adresses IP associées à l’ordinateur local. L’un de ces noms d’hôte ou adresses IP peut ensuite être utilisé pour le paramètre hostName .

Le constructeur échoue si le paramètre hostName a la valeur null ou contient une chaîne vide.

S’applique à

Voir aussi