MSDN Library
信息
您所需的主题如下所示。但此主题未包含在此库中。

DataPackageView Class

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

语法


var dataPackageView = shareOperation.data;

特性

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

成员

DataPackageView类 具有这些类型的成员:

方法

The DataPackageView 类 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
Contains Checks to see if the DataPackageView contains a specific data format.
GetApplicationLinkAsync Gets the application link in the DataPackageView object.
GetBitmapAsync Gets the bitmap image contained in the DataPackageView
GetDataAsync Gets the data contained in the DataPackageView.
GetHtmlFormatAsync Gets the HTML stored in the DataPackageView object.
GetResourceMapAsync Gets the data (such as an image) referenced in HTML content.
GetRtfAsync Gets the rich text formatted (RTF) content contained in a DataPackageView.
GetStorageItemsAsync Gets the files and folders stored in a DataPackageView object.
GetTextAsync() Gets the text in the DataPackageView object.
GetTextAsync(String) Gets the text in the DataPackageView object.
GetUriAsync Gets the URI contained in the DataPackageView.
GetWebLinkAsync Gets the web link in the DataPackageView object.
ReportOperationCompleted Informs the system that your app is finished using the DataPackageView object. Primarily used for Clipboard operations.

 

属性

DataPackageView类 具有这些属性。

属性访问类型说明

AvailableFormats

只读Returns the formats the DataPackageView contains.

Properties

只读Gets a DataPackagePropertySetView object, which contains a read-only set of properties for the data in the DataPackageView object.

RequestedOperation

只读Gets the requested operation (such as copy or move). Primarily used for Clipboard actions.

 

备注

共享操作期间,源应用程序将共享数据放入 DataPackage 对象中,并将该对象发送到目标应用程序以进行处理。DataPackage 类包括大量支持以下默认格式的方法:textRtfHtmlBitmapStorageItems。它还具有支持自定义数据格式的方法。若要使用这些格式,源应用程序和目标应用程序必须已经知道该自定义格式存在。

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

源应用程序具有使用 SetDataProvider 将委托分配给 DataPackage、而不是立即提供数据的选项。此过程可用于源应用程序支持给定格式,但只有在目标应用程序请求时才生成数据的情况。 例如,源应用程序可能支持各种共享图片的图像格式。代替使用这些格式创建每个图像的多个副本,源应用程序可以使用一个在目标应用程序请求特定格式类型时调用的委托。

Windows Phone 8

此 API 不实现,但是调用时会引发异常。请参见 Windows Phone 运行时 API

示例

以下代码显示您可以如何使用 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);
        }
    });
}


要求

最低支持客户端

Windows 8 [Windows 应用商店应用程序, 桌面应用程序]

最低支持服务器

Windows Server 2012 [Windows 应用商店应用程序, 桌面应用程序]

最低支持电话

Windows Phone 8 [未实现,请参见备注]

命名空间

Windows.ApplicationModel.DataTransfer
Windows::ApplicationModel::DataTransfer [C++]

元数据

Windows.winmd

另请参见

共享内容目标应用程序示例
快速入门:共享内容(使用 JavaScript 编写的 Windows Store 应用程序)
快速入门:共享内容(使用 C#/VB/C++ 和 XAML 编写的 Windows Store 应用程序)
快速入门:接收共享内容(使用 JavaScript 编写的 Windows Store 应用程序)
快速入门:接收共享内容(使用 C#/VB/C++ 和 XAML 编写的 Windows Store 应用程序)

 

 

显示:
© 2016 Microsoft