共用方式為

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 格式 (RTF) 包含在 DataPackageView中的 RTF。
GetStorageItemsAsync()

取得儲存在 DataPackageView 物件中的檔案和資料夾。
GetTextAsync()

取得 DataPackageView 物件中的文字。
GetTextAsync(String)

取得 DataPackageView 物件中的文字。
GetUriAsync()

注意

GetUriAsync 可能會在Windows 8.1之後變更或無法使用版本。 請改用 GetApplicationLink 或 GetWebLink。

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

取得 DataPackageView 物件中的 Web 連結。
ReportOperationCompleted(DataPackageOperation)

通知系統您的應用程式已完成 使用 DataPackageView 物件。 主要用於剪貼簿作業。
RequestAccessAsync()

要求解除鎖定和存取使用保護原則保護的資料套件許可權。
RequestAccessAsync(String)

要求解除鎖定和存取使用保護原則保護的資料套件許可權。
SetAcceptedFormatId(String)

設定接受的格式識別碼。
UnlockAndAssumeEnterpriseIdentity()

解除鎖定資料套件，並假設有企業身分識別。

適用於

另請參閱