导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

DataPackage Class

包含用户希望与另一个应用程序交换的数据。

语法


var dataPackage = new Windows.ApplicationModel.DataTransfer.DataPackage();

特性

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

成员

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

构造函数

DataPackage类 具有这些构造函数。

构造函数说明
DataPackage Constructor that creates a new DataPackage.

 

事件

DataPackage类 具有这些事件。

事件说明
Destroyed Occurs when the DataPackage is destroyed.
OperationCompleted Occurs when a paste operation is completed.

 

方法

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

方法说明
GetView Returns a DataPackageView object. This object is a read-only copy of the DataPackage object.
SetApplicationLink Sets the application link that a DataPackage contains.
SetBitmap Sets the bitmap image contained in the DataPackage.
SetData Sets the data contained in the DataPackage in a RandomAccessStream format.
SetDataProvider Sets a delegate to handle requests from the target app.
SetHtmlFormat Adds HTML content to the DataPackage.
SetRtf Sets the Rich Text Format (RTF) content that is contained in a DataPackage.
SetStorageItems(IIterable(IStorageItem)) Sets the files and folders contained in a DataPackage.
SetStorageItems(IIterable(IStorageItem), Boolean) Adds files and folders to a DataPackage.
SetText Sets the text that a DataPackage contains.
SetUri Sets the Uniform Resource Identifier (URI) that is contained in the DataPackage.
SetWebLink Sets the web link that a DataPackage contains.

 

属性

DataPackage类 具有这些属性。

属性访问类型说明

Properties

只读Allows you to get and set properties like the title of the content being shared.

RequestedOperation

读/写Specifies the DataPackageOperation (none, move, copy, or link) for the operation.

ResourceMap

只读Maps a URI to a file. Used to ensure that referenced content (such as an image) in HTML content is added to the DataPackage.

 

备注

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

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

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

Windows Phone 8

只有本机应用程序支持此 API。

示例


function registerForShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareTextHandler);
}

function shareTextHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Text Example";
    request.data.properties.description = "A demonstration that shows how to share.";
    request.data.setText("Hello World!");
}


要求

最低支持客户端

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

最低支持服务器

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

最低支持电话

Windows Phone 8

命名空间

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

元数据

Windows.winmd

 

 

显示:
© 2014 Microsoft