HostName(String) Konstruktor
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.