DataRequest.Data プロパティ

定義

名前空間:

Windows.ApplicationModel.DataTransfer

ユーザーが共有するコンテンツを含む DataPackage オブジェクトを設定または取得します。

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

プロパティ値

DataPackage

ユーザーが共有するコンテンツが含まれます。

例

次のコードは、 DataPackage 上のデータ を別のアプリと共有するように設定する一環として、Data プロパティから DataPackage オブジェクトを取得する方法を示しています。

//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!");
}

注釈

Data プロパティを使用すると、アプリでターゲット アプリにデータを提供できます。 アプリでは、 DataPackage オブジェクトを使用してこのデータを提供する必要があります。

このプロパティは、ユーザーが共有するコンテンツがアプリですぐに利用できる場合に使用します。 DataPackage を生成するために関数を呼び出す必要がある場合は、GetDeferral メソッドを使用します。

アプリで DataPackage オブジェクトを指定できない場合は、 FailWithDisplayText メソッドを使用して共有を取り消し、ターゲット アプリがユーザーに表示できるメッセージを提供します。