HostName(String) 建構函式

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

從包含主機名稱或 IP 位址的字串建立新的 HostName 物件。

public:
 HostName(Platform::String ^ hostName);

 HostName(winrt::hstring const& hostName);

public HostName(string hostName);

function HostName(hostName)

Public Sub New (hostName As String)

包含主機名稱或 IP 位址的字串。

此建構函式會建立新的 HostName 物件。 hostName參數可以包含主機名稱或 IP 位址。 HostName物件可用於本機主機名稱或遠端主機名。

hostName參數可以包含下列其中一項：

網域名稱系統 (DNS) 或其他命名空間提供者解析的主機名稱稱。
符合本機電腦上下列檔案中字串的主機名稱稱： %WINDIR%\system32\drivers\etc\hosts
包含主機 IPv4 或 IPv6 網路位址的字串。例如，IPv4 位址字串是以點符號標記法 (「192.168.1.111」，例如) 。 IPv6 位址以十六進位標記法 (「21DA：00D3：0010：2F3B：02AA：00FF：FE28：9C5A」，例如) 。如果 hostName 參數是「localhost」字串，這代表本機電腦上的所有回送位址。

Windows.Networking.Connectivity命名空間中的NetworkInformation.GetHostNames方法可用來擷取與本機電腦相關聯的主機名稱或 IP 位址清單。然後，這些主機名稱或 IP 位址之一可用於 hostName 參數。

如果 hostName 參數為 null 或包含空字串，建構函式將會失敗。