DataTransferManager 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
以编程方式启动与其他应用的内容交换。
public ref class DataTransferManager sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class DataTransferManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataTransferManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class DataTransferManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataTransferManager
Public NotInheritable Class DataTransferManager
- 继承
- 属性
Windows 要求
设备系列 |
Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
|
API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
示例
此示例演示使用 DataTransferManager 对象的典型方法。
function setupShare() {
var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
dataTransferManager.addEventListener("datarequested", function (e) {
var request = e.request;
request.data.properties.title = "Share Demonstration";
request.data.setText("Hello World!");
});
}
注解
DataTransferManager 类是用于启动共享操作的静态类。 若要使用 类,请首先调用 GetForCurrentView 方法。 此方法返回特定于活动窗口的 DataTransferManager 对象。 接下来,需要向 对象添加 datarequested 事件的事件侦听器。 此事件在共享操作启动时触发,通常当用户点击“共享”超级按钮时触发,但如果应用以编程方式启动共享操作,也会触发此事件。
DataTransferManager 类包括 ShowShareUI 方法,可用于以编程方式启动共享操作。
DataTransferManager 类还具有 TargetApplicationChosen 事件。 如果要捕获用户在共享应用中的内容时选择的应用程序,请使用此事件。
注意
此类不敏捷,这意味着需要考虑其线程模型和封送处理行为。 有关详细信息,请参阅线程和封送处理 (C++/CX) 和使用多线程环境中的Windows 运行时对象 (.NET) 。
Windows Phone 8
此 API 仅在本机应用中受支持。
版本历史记录
Windows 版本 | SDK 版本 | 已添加值 |
---|---|---|
1607 | 14393 | IsSupported |
1703 | 15063 | ShareProvidersRequested |
1709 | 16299 | ShowShareUI (ShareUIOptions) |
方法
GetForCurrentView() |
返回与当前窗口关联的 DataTransferManager 对象。 |
IsSupported() |
如果设备支持共享,则返回 true;否则返回 false。 |
ShowShareUI() |
以编程方式启动用户界面,以便与其他应用共享内容。 此 API 适用于 通用 Windows 平台 (UWP) 应用。 显示依赖于 CoreWindow 的 WinRT UI 对象中介绍了用于桌面应用的替代 API。 |
ShowShareUI(ShareUIOptions) |
以编程方式启动用户界面,以便与其他应用共享内容。 此 API 适用于 通用 Windows 平台 (UWP) 应用。 显示依赖于 CoreWindow 的 WinRT UI 对象中介绍了用于桌面应用的替代 API。 |
事件
DataRequested |
在共享操作启动时发生。 |
ShareProvidersRequested |
请求共享提供程序时触发的事件。 它用作回调,通过订阅此事件并在事件处理程序中调用 ShareProvidersRequestedEventArgs.Providers.Add () 来添加提供程序。 |
TargetApplicationChosen |
当用户在共享 UI 中选择目标应用时发生。 |