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 参数可以包含以下项之一：

• 用于 http 的 TCP 端口的 TCP 或 UDP 端口号的数字文本 (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 参数可以包含以下项之一：

• 用于 http 的 TCP 端口的 TCP 或 UDP 端口号的数字文本 (80，例如，) 。
• 端口号 (“http”的字符串别名，例如，与本地计算机上以下文件中的字符串匹配的) ： %WINDIR%\system32\drivers\etc\services
• 可由命名空间提供程序使用 SRV 记录解析的服务名称。 如果 remoteServiceName 参数为 null 或包含空字符串，构造函数将失败。

另请参阅

• Windows.Networking