DataTransferManager 类

定义

命名空间:

Windows.ApplicationModel.DataTransfer

以编程方式启动与其他应用的内容交换。

public ref class DataTransferManager sealed

/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataTransferManager

Public NotInheritable Class DataTransferManager

继承

Object Platform::Object IInspectable DataTransferManager

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 中选择目标应用时发生。

另请参阅

• 共享内容源应用示例 (Windows 10)