通过

DataPackageView 类

  • 参考

定义

命名空间:
Windows.ApplicationModel.DataTransfer
编辑

DataPackage 的只读版本。 接收共享内容的应用在获取内容时获取此对象。

public ref class DataPackageView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackageView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackageView
Public NotInheritable Class DataPackageView
继承
Object Platform::Object IInspectable DataPackageView
属性
ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下代码演示如何使用 DataPackageView 获取正在共享的文本。 若要使此示例正常工作，需要添加代码来检测应用是否已启动以响应共享操作。 请参阅主题 如何接收文本 以了解详细信息。

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

注解

在共享操作期间，源应用将共享的数据放在 DataPackage 对象中，并将该对象发送到目标应用进行处理。 DataPackage 类包括许多支持以下默认格式的方法：text、Rtf、Html、Bitmap 和 StorageItems。 它还具有支持自定义数据格式的方法。 若要使用这些格式，源应用和目标应用必须已知道自定义格式存在。

目标应用可以使用 DataPackageView 对象来获取要共享的数据。 此外，这些应用可以使用 AvailableFormats 属性来标识 DataPackageView 支持的格式，或使用 Contains 方法查询特定格式。

源应用可以选择使用 SetDataProvider 将委托分配给 DataPackage，而不是立即提供数据。 如果源应用支持给定格式，但不希望生成数据，除非目标应用请求，否则此过程非常有用。 例如，源应用可能支持用于共享照片的各种图像格式。 源应用可以使用在目标应用请求特定格式类型时调用的委托，而不是使用这些格式创建每个图像的多个副本。

版本历史记录

Windows 版本 SDK 版本 增值
1511 10586 SetAcceptedFormatId

属性

AvailableFormats

返回 DataPackageView 包含的格式。
Properties

获取 DataPackagePropertySetView 对象，该对象包含 DataPackageView 对象中数据的一组只读属性。
RequestedOperation

获取请求的操作 (，例如复制或移动) 。 主要用于剪贴板操作。

方法

Contains(String)

检查 DataPackageView 是否包含特定数据格式。
GetApplicationLinkAsync()

获取 DataPackageView 对象中的应用程序链接。
GetBitmapAsync()

获取 DataPackageView 中包含的位图图像
GetDataAsync(String)

获取 DataPackageView 中包含的数据。
GetHtmlFormatAsync()

获取 存储在 DataPackageView 对象中的 HTML。
GetResourceMapAsync()

获取数据 (，例如) HTML 内容中引用的图像。
GetRtfAsync()

获取 RTF) DataPackageView 中包含的内容格式 (格式的 RTF。
GetStorageItemsAsync()

获取 存储在 DataPackageView 对象中的文件和文件夹。
GetTextAsync()

获取 DataPackageView 对象中的文本。
GetTextAsync(String)

获取 DataPackageView 对象中的文本。
GetUriAsync()

注意

Windows 8.1后，GetUriAsync 可能会更改或不可用于发布。 请改用 GetApplicationLink 或 GetWebLink。

获取 DataPackageView 中包含的 URI。
GetWebLinkAsync()

获取 DataPackageView 对象中的 Web 链接。
ReportOperationCompleted(DataPackageOperation)

通知系统你的应用已使用 DataPackageView 对象完成。 主要用于剪贴板操作。
RequestAccessAsync()

请求解锁和访问受保护策略保护的数据包的权限。
RequestAccessAsync(String)

请求解锁和访问受保护策略保护的数据包的权限。
SetAcceptedFormatId(String)

设置接受的格式 ID。
UnlockAndAssumeEnterpriseIdentity()

解锁数据包并为其假定企业标识。

适用于

另请参阅