TargetFileRequestDeferral 类

定义

命名空间:

Windows.Storage.Pickers.Provider

由提供保存位置的应用使用，以异步方式指示应用已完成对 TargetFileRequested 事件的响应。

public ref class TargetFileRequestDeferral sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequestDeferral final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequestDeferral

Public NotInheritable Class TargetFileRequestDeferral

继承

Object Platform::Object IInspectable TargetFileRequestDeferral

属性

ContractVersionAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

文件选取器示例演示如何响应 TargetFileRequested 事件处理程序，包括如何获取延迟。

// Event handler
private async void OnTargetFileRequested(FileSavePickerUI sender, TargetFileRequestedEventArgs e)
{
    // Respond to TargetFileRequested event on the background thread on which it was raised

    // Requesting a deferral allows the app to call another asynchronous method and complete the request at a later time
    var deferral = e.Request.GetDeferral();

    // Create file and assign to TargetFile property
    e.Request.TargetFile = await ApplicationData.Current.LocalFolder.CreateFileAsync(sender.FileName, CreationCollisionOption.GenerateUniqueName);

    // Complete the deferral to let the Picker know the request is finished
    deferral.Complete();
}

// Register for the event
fileSavePickerUI.TargetFileRequested += new TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs>(OnTargetFileRequested);

在示例中， e 包含 TargetFileRequestedEventArgs 对象。

注解

如果你的应用参与文件保存选取器合约，并且 触发了 TargetFileRequested 事件，则你的应用应创建一个新的 StorageFile 来表示用户想要保存的文件。 创建的 StorageFile 的名称必须与 FileName 属性指定的文件的名称匹配。 创建的 StorageFile 将返回到调用应用 (调用文件选取器的应用) ，以便调用应用可以将内容写入文件。 详细了解如何在 targetFileRequestedEventArgs 中响应此事件。

应用作为保存位置的提供程序，可以通过调用 targetFileRequestDeferral.complete 来指示它已完成对 TargetFileRequested 事件的异步响应。 详细了解如何在 TargetFileRequestedEventArgs 中异步响应 TargetFileRequested 事件。

方法

Complete()

指示提供保存位置的应用已完成对 TargetFileRequested 事件的响应。