EndpointPair(HostName, String, HostName, String) 建構函式

定義

命名空間:

Windows.Networking

建立新的 EndpointPair 物件。

public:
 EndpointPair(HostName ^ localHostName, Platform::String ^ localServiceName, HostName ^ remoteHostName, Platform::String ^ remoteServiceName);

 EndpointPair(HostName const& localHostName, winrt::hstring const& localServiceName, HostName const& remoteHostName, winrt::hstring const& remoteServiceName);

public EndpointPair(HostName localHostName, string localServiceName, HostName remoteHostName, string remoteServiceName);

function EndpointPair(localHostName, localServiceName, remoteHostName, remoteServiceName)

Public Sub New (localHostName As HostName, localServiceName As String, remoteHostName As HostName, remoteServiceName As String)

參數

localHostName

HostName

EndpointPair物件的本機主機名稱或 IP 位址。

localServiceName

String

Platform::String

winrt::hstring

EndpointPair物件的本機服務名稱或本機 TCP 或 UDP 埠號碼。

remoteHostName

HostName

EndpointPair物件的遠端主機名或 IP 位址。

remoteServiceName

String

Platform::String

winrt::hstring

EndpointPair物件的遠端服務名稱或遠端 TCP 或 UDP 埠號碼。

備註

此建構函式會從本機主機名稱、本機服務名稱、遠端主機名和遠端服務名稱建立新的 EndpointPair 物件。 EndpointPair物件提供網路應用程式用於本機端點的資料，以及網路連線的遠端端點。

端點包含兩個元件：

• 主機名稱或 IP 位址。

• 服務名稱或 TCP 或 UDP 埠號碼。 端點組包含兩個元件：

• 網路連線的本機端點。

• 網路連線的遠端端點。 localHostName參數可以包含下列其中一項：

• 可由網域名稱系統 (DNS) 或其他命名空間提供者解析的本機主機名稱稱。

• 本機電腦上的下列檔案中符合字串的本機主機名稱稱： %WINDIR%\system32\drivers\etc\hosts

• 字串，包含本機主機的 IPv4 或 IPv6 網路位址。 例如，IPv4 位址字串是以點符號標記法 (「192.168.1.111」，例如) 。 IPv6 位址以十六進位標記法 (「21DA：00D3：0010：2F3B：02AA：00FF：FE28：9C5A」，例如) 。 如果 localHostName 參數是 「localhost 」 字串，這代表本機電腦上的所有回送位址。

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

localHostName參數也可以設定為 null。 如果在用戶端應用程式建立網路連線之前 localHostName 為 null，則系統會自動提供本機 IP 位址供應用程式使用。

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

• TCP 或 UDP 埠號碼的數值常值， (HTTP 所使用的 TCP 埠 80，例如) 。
• 埠號碼 (「HTTP」 的字串別名，例如) 符合本機電腦上的下列檔案中的字串： %WINDIR%\system32\drivers\etc\services
• 可使用 SRV 記錄的命名空間提供者解析的服務名稱。 localServiceName參數也可以包含空字串。 如果在建立網路連線之前，本機端點的本機服務名稱是空字串，則系統會自動提供 TCP 或 UDP IP 埠號碼，讓應用程式在建立網路連線時使用。

如果 localServiceName 參數為 null，建構函式將會失敗。

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

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

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

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

• TCP 或 UDP 埠號碼的數值常值， (HTTP 所使用的 TCP 埠 80，例如) 。
• 埠號碼 (「HTTP」 的字串別名，例如) 符合本機電腦上的下列檔案中的字串： %WINDIR%\system32\drivers\etc\services
• 可使用 SRV 記錄的命名空間提供者解析的服務名稱。 如果 remoteServiceName 參數為 null 或包含空字串，建構函式將會失敗。

另請參閱

• Windows.Networking