HostName(String) Constructeur
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.