DatagramSocket.BindEndpointAsync(HostName, String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
启动 对 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 端口。
返回
对 DatagramSocket 对象执行的异步绑定操作。
- 属性
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 用于向单个终结点发送数据以及从单个终结点接收数据。