DataPackage クラス

定義

public ref class DataPackage sealed

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackage final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DataPackage final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataPackage final

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackage

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DataPackage

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataPackage

function DataPackage()

Public NotInheritable Class DataPackage

継承

Object Platform::Object IInspectable DataPackage

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

例

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

注釈

共有操作中に、ソース アプリは、共有されているデータを DataPackage オブジェクトに格納し、そのオブジェクトをターゲット アプリに送信して処理します。 DataPackage クラスには、text、Rtf、Html、Bitmap、および StorageItems という既定の形式をサポートする多数のメソッドが含まれています。 また、カスタム データ形式をサポートするメソッドもあります。 これらの形式を使用するには、ソース アプリとターゲット アプリの両方で、カスタム形式が存在することを既に認識している必要があります。

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

ターゲット アプリでは、 DataPackageView オブジェクトを使用して、共有されているデータを取得できます。 さらに、これらのアプリでは AvailableFormats プロパティを使用して 、DataPackageView でサポートされている形式を特定したり、 Contains メソッドを使用して特定の形式を照会したりできます。

Windows Phone 8

この API はネイティブ アプリでのみサポートされています。

バージョン履歴

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• クリップボードのサンプル (Windows 10)
• コンテンツ ソース アプリの共有のサンプル (Windows 10)