DataRequest クラス

定義

名前空間:

Windows.ApplicationModel.DataTransfer

エラーが発生した場合に、ユーザーが共有またはメッセージを指定するコンテンツをアプリで提供できるようにします。

public ref class DataRequest sealed

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

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

Public NotInheritable Class DataRequest

継承

Object Platform::Object IInspectable DataRequest

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

次のコードは、DataPackage のデータを別のアプリと共有する設定の一環として DataRequest オブジェクトを使用する方法を示しています。

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

注釈

datarequested イベントが発生すると、アプリは DataRequest オブジェクトを受け取ります。 このオブジェクトを使用すると、アプリは DataPackage オブジェクトを使用してターゲット アプリにデータを提供したり、遅延オブジェクトを使用して関数を呼び出したり、ターゲット アプリにエラーが発生したことを通知したりできます。

プロパティ

Data	ユーザーが共有するコンテンツを含む DataPackage オブジェクトを設定または取得します。
Deadline	遅延レンダリング操作を完了するための期限を取得します。 実行が期限を超えた場合、遅延レンダリングの結果は無視されます。

メソッド

FailWithDisplayText(String)	共有操作を取り消し、ユーザーに表示するエラー文字列を指定します。
GetDeferral()	DataRequestDeferral オブジェクトを作成して返すことによって、非同期共有操作をサポートします。