信息
您所需的主题如下所示。但此主题未包含在此库中。

EndpointPair.EndpointPair Constructor

创建新的 EndpointPair 对象。

语法


var endpointPair = new Windows.Networking.EndpointPair(localHostName, localServiceName, remoteHostName, remoteServiceName);

参数

localHostName

类型: HostName

EndpointPair 对象的本地主机名或 IP 地址。

localServiceName

类型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

EndpointPair 对象的本地服务名称,或本地 TCP 或 UDP 端口号。

remoteHostName

类型: HostName

EndpointPair 对象的远程主机名称或 IP 地址。

remoteServiceName

类型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

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 端口号的数字文本(例如,TCP 端口 80 用于 http)。
  • 在本地计算机上与以下文件的字符串匹配的端口号的字符串别名,(例如“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 端口号的数字文本(例如,TCP 端口 80 用于 http)。
  • 在本地计算机上与以下文件的字符串匹配的端口号的字符串别名,(例如“http”):%WINDIR%\system32\drivers\etc\services
  • 服务名称可由命名空间提供程序使用 SRV 记录解析。

如果 remoteServiceName 参数为 null,或包含空字符串,则该构造函数将失败。

要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8

命名空间

Windows.Networking
Windows::Networking [C++]

元数据

Windows.winmd

DLL

Windows.Networking.dll

另请参见

EndpointPair
Windows.Networking

 

 

显示: