Freigeben über


HostName(String) Konstruktor

Definition

Erstellt ein neues HostName-Objekt aus einer Zeichenfolge, die einen Hostnamen oder eine IP-Adresse enthält.

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

Parameter

hostName
String

Platform::String

winrt::hstring

Eine Zeichenfolge, die einen Hostnamen oder eine IP-Adresse enthält.

Hinweise

Dieser Konstruktor erstellt ein neues HostName-Objekt . Der hostName-Parameter kann einen Hostnamen oder eine IP-Adresse enthalten. Ein HostName-Objekt kann für einen lokalen Hostnamen oder einen Remotehostnamen verwendet werden.

Der HostName-Parameter kann eine der folgenden Elemente enthalten:

  • Der Name eines Hosts, der vom Domain Name System (DNS) oder einem anderen Namespaceanbieter aufgelöst werden kann.
  • Der Name eines Hosts, der einer Zeichenfolge in der folgenden Datei auf dem lokalen Computer entspricht: %WINDIR%\system32\drivers\etc\hosts
  • Eine Zeichenfolge, die eine IPv4- oder eine IPv6-Netzwerkadresse des Hosts enthält. Eine IPv4-Adresszeichenfolge ist in gepunkteter Dezimalschreibweise ("192.168.1.111", z. B. 192.168.1.111). Eine IPv6-Adresse befindet sich in hexadezimaler Notation ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", z. B. 21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A). Wenn der hostName-Parameter die Zeichenfolge "localhost" ist, stellt dies alle Loopbackadressen auf dem lokalen Computer dar.

Die NetworkInformation.GetHostNames-Methode im Windows.Networking.Connectivity-Namespace kann verwendet werden, um eine Liste von Hostnamen oder IP-Adressen abzurufen, die dem lokalen Computer zugeordnet sind. Eine dieser Hostnamen oder IP-Adressen kann dann für den hostName-Parameter verwendet werden.

Der Konstruktor schlägt fehl, wenn der hostName-Parameter NULL ist oder eine leere Zeichenfolge enthält.

Gilt für:

Weitere Informationen