DatagramSocket.BindEndpointAsync(HostName, String) 方法

定义

命名空间:

Windows.Networking.Sockets

启动 对 DatagramSocket 到本地主机名和本地服务名称的绑定操作。

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);

function bindEndpointAsync(localHostName, localServiceName)

Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

参数

localHostName

HostName

要绑定 DatagramSocket 对象的本地主机名或 IP 地址。

localServiceName

String

Platform::String

winrt::hstring

要绑定 DatagramSocket 对象的本地服务名称或 UDP 端口。

返回

IAsyncAction

对 DatagramSocket 对象执行的异步绑定操作。

属性

RemoteAsyncAttribute

Windows 要求

应用功能	ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

注解

BindEndpointAsync 方法将 DatagramSocket 绑定到 localHostName 参数中指定的本地主机名或 IP 地址，以及 localServiceName 参数中指定的本地服务名称或 UDP 端口号地址。 如果 localHostName 参数为 null，系统将选择要绑定的本地 IP 地址。 如果 localServiceName 参数为空字符串，系统将选择要绑定的本地 UDP 端口。

除非已使用 DatagramSocketControl.MulticastOnly 属性，否则如果另一个使用 UDP (的应用（例如，另一个 DatagramSocket) 已绑定到 localHostName 和 localServiceName 参数中指定的本地 IP 地址和 UDP 端口），BindEndpointAsync 方法将失败。

绑定对于从 DatagramSocket 上的任何远程终结点接收数据至关重要，通常在创建套接字并设置 MessageReceived 事件后完成。 BindServiceNameAsync 或 BindEndpointAsync 方法用于将 DatagramSocket 绑定到本地服务名称或 UDP 端口。 如果套接字尚未绑定， ConnectAsync 方法也将导致绑定操作。 写入由其中一个 GetOutputStreamAsync 方法返回的流也会导致绑定操作。

在以下情况下，不需要 BindServiceNameAsync 和 BindEndpointAsync 方法：

• DatagramSocket 仅用于发送数据。
• DatagramSocket 用于向单个终结点发送数据以及从单个终结点接收数据。

另请参阅

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived