DataPackageView Class

DataPackage の読み取り専用バージョン。共用コンテンツを受信するアプリケーションは、コンテンツ取得時にこのオブジェクトを得ます。

構文

public sealed class DataPackageView : Object

属性

DualApiPartitionAttribute()

MarshalingBehaviorAttribute(Agile)

VersionAttribute(NTDDI_WIN8)

メンバー

DataPackageViewクラス には次の種類のメンバーが含まれます:

• メソッド
• プロパティ

メソッド

The DataPackageView クラス には次のメソッドがあります。C#、Visual Basic、C++ では、次のもののメソッドも継承しますObject クラス.

プロパティ

DataPackageViewクラス次のプロパティがあります。

注釈

共有操作中に、ソース アプリケーションは共有されているデータを DataPackage オブジェクトに設置し、処理のためオブジェクトをターゲット アプリに送信します。DataPackage クラスには、次の既定の形式をサポートする多くのメソッドが含まれます。text、Rtf、Html、Bitmap、StorageItems。また、カスタム データ形式をサポートするメソッドもあります。これらの形式を使用するには、ソース アプリケーションとターゲット アプリケーションの両方は、カスタム形式が存在することを既に注意している必要があります。

ターゲット アプリケーションは、共有するデータの取得に DataPackageView オブジェクトを使用できます。さらに、これらのアプリは、DataPackageView がサポートするフォーマットを識別する AvailableFormats プロパティ、または特定の形式を照会する Contains メソッドを使用できます。

データをすぐに提供する代わりに DataPackage にデリゲートを割り当てる SetDataProvider を使用するオプションがソース アプリケーションにはあります。このプロセスは、ソース アプリケーションが指定された書式をサポートしていても、ターゲット アプリケーションが要求しない限りはデータを生成する必要がない場合に便利です。 たとえば、ソース アプリケーションは、写真を共有するためのさまざまなイメージ形式をサポートする場合があります。これらの書式を使用して各イメージのコピーを複数作成する代わりに、ソース アプリケーションは、対象のアプリケーションが特定の書式の種類を要求したときに呼び出されるデリゲートを使用できます。

Windows Phone 8

この 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);
        }
    });
}

要件

参照

コンテンツ ターゲット アプリケーション サンプルの共有

クイック スタート: コンテンツの共有 (JavaScript を使った Windows Store アプリ)

クイック スタート: コンテンツの共有 (C#/VB/C++ と XAML を使った Windows Store アプリ)

クイック スタート: 共有コンテンツの受信 (JavaScript を使った Windows Store アプリ)

クイック スタート: 共有コンテンツの受信 (C#/VB/C++ と XAML を使った Windows Store アプリ)