DataProviderDeferral クラス

定義

名前空間:

Windows.ApplicationModel.DataTransfer

ソース アプリの遅延デリゲートによって使用され、ソース アプリが別の非同期関数からデータを生成することを DataPackage オブジェクトに通知します。

public ref class DataProviderDeferral sealed

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

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

Public NotInheritable Class DataProviderDeferral

継承

Object Platform::Object IInspectable DataProviderDeferral

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

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

例

次のコードは、DataProviderDeferral オブジェクトを使用してターゲット アプリからの要求を延期する方法を示しています。

async private void OnDeferredImageRequestedHandler(DataProviderRequest request)
{
    if (this.imageFile != null)
    {
        // A deferral object is required because this method uses "await" before setting the 
        // data in the DataPackage.
        var deferral = request.GetDeferral();

        var imageStream = await this.imageFile.OpenAsync(FileAccessMode.Read);

        // Decode the image.
        var imageDecoder = await BitmapDecoder.CreateAsync(imageStream);

        // Re-encode the image at 50% width and height.
        var inMemoryStream = new InMemoryRandomAccessStream();
        var imageEncoder = await BitmapEncoder.CreateForTranscodingAsync(inMemoryStream, imageDecoder);
        imageEncoder.BitmapTransform.ScaledWidth = (uint)(imageDecoder.OrientedPixelWidth * 0.5);
        imageEncoder.BitmapTransform.ScaledHeight = (uint)(imageDecoder.OrientedPixelHeight * 0.5);
        await imageEncoder.FlushAsync();

        request.SetData(RandomAccessStreamReference.CreateFromStream(inMemoryStream));

        await log(OutputText, "Image has been set via deferral");

        // The data is set. Signal that the operation is complete.
        deferral.Complete();
    }
    else
    {
        await log(OutputText, "Error: imageFile is null");
    }
}

注釈

ソース アプリには、すぐに形式を指定するのではなく、ターゲット アプリに有望なデータ形式を指定するオプションがあります。 一般的な例は、ソース アプリが JPG などのイメージ形式をサポートしているが、ターゲット アプリが要求しない限り形式を作成しない場合です。 共有コンテンツ ソース アプリのサンプルをダウンロードすることもできます。

メソッド

Complete()

処理の準備ができていることを DataPackage に 通知します。