DataPackageView クラス

定義

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 の要件

例

次のコードは、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 にデリゲートを割り当てるオプションがあります。 このプロセスは、ソース アプリが特定の形式をサポートしているが、ターゲット アプリがデータを要求しない限りデータを生成しない場合に便利です。 たとえば、ソース アプリでは、写真を共有するためのさまざまな画像形式がサポートされている場合があります。 ソース アプリでは、これらの形式を使用して各イメージの複数のコピーを作成する代わりに、ターゲット アプリが特定の形式の種類を要求したときに呼び出されるデリゲートを使用できます。

バージョン履歴

プロパティ

メソッド

適用対象

こちらもご覧ください

• コンテンツ共有ターゲット アプリのサンプルに関するページ
• クイック スタート: コンテンツの共有 (JavaScript を使用)
• データの共有
• クイック スタート: 共有コンテンツの受信 (JavaScript を使用)
• データの受信
• コンテンツ ターゲット アプリの共有サンプル (Windows 10)
• コンテンツ ソース アプリの共有のサンプル (Windows 10)
• アプリ パッケージ情報のサンプル (Windows 10)