DataRequest.GetDeferral メソッド

定義

名前空間:

Windows.ApplicationModel.DataTransfer

DataRequestDeferral オブジェクトを作成して返すことで、非同期共有操作をサポートします。

public:
 virtual DataRequestDeferral ^ GetDeferral() = GetDeferral;

DataRequestDeferral GetDeferral();

public DataRequestDeferral GetDeferral();

function getDeferral()

Public Function GetDeferral () As DataRequestDeferral

戻り値

DataRequestDeferral

コンテンツを非同期的に共有または送信できる オブジェクト。

例

次の例は、GetDeferral メソッドを使用して DataRequestDeferral オブジェクトを取得する方法を示しています。

void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequestDeferral deferral = e.Request.GetDeferral();
    e.Request.Data.Properties.Title = "Hello World!";
    e.Request.Data.Properties.Description = "This example shows how to share files and images.";
    if (this.dataPackageThumbnail != null)
    {
        e.Request.Data.Properties.Thumbnail = this.dataPackageThumbnail;
    }
    e.Request.Data.SetBitmap(imageStreamRef);
    deferral.Complete();
}

注釈

GetDeferral メソッドを使用すると、アプリは共有操作中に関数を呼び出すことができます。これにより、アプリはターゲット アプリの DataPackage オブジェクトを非同期的に生成できます。

非同期関数呼び出しを使用して共有操作中に DataPackage を生成する場合は、このメソッドを使用します。 この関数は、操作のタイムアウトを防ぐために、200 ミリ秒以内に DataPackage オブジェクトを返す必要があります。ファイルや写真のコレクションなど、パッケージ化に時間がかかるコンテンツをアプリで共有する場合は、このメソッドを使用しないでください。 代わりに、 SetDataProvider メソッドを使用して DataPackage にデリゲートを割り当て、その DataPackage をターゲット アプリに返します。