DataPackage 類別

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。它也具有支援自訂資料格式的方法。若要使用這些格式,來源應用程式與目標應用程式都必須知道有自訂格式存在。

來源應用程式提供使用 SetDataProvider 將委派指派給 DataPackage 的選項,而不是立即提供資料。這個處理序在來源應用程式支援特定格式,但是僅在目標應用程式要求資料時才產生資料的情況下十分有用。 例如,來源應用程式可能支援各種用於共用相片的影像格式。來源應用程式可以使用在目標應用程式要求特定格式型別時被呼叫的委派,而不使用這些格式建立每個影像的多個複本。

目標應用程式可以使用 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++]

Metadata

Windows.winmd

 

 

顯示:
© 2017 Microsoft