共用方式為


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

定義

建立新的 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 或包含空字串,建構函式將會失敗。

適用於

另請參閱