TargetFileRequest 类

定义

命名空间:

Windows.Storage.Pickers.Provider

允许提供保存位置的应用指定表示要保存的文件的 StorageFile 并获取延迟，以便应用可以异步响应 TargetFileRequested 事件。

public ref class TargetFileRequest sealed

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

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

Public NotInheritable Class TargetFileRequest

继承

Object Platform::Object IInspectable TargetFileRequest

属性

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 事件处理程序，包括如何使用 Request 属性获取 TargetFileRequest。

// 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 中详细了解如何响应此事件。

属性

TargetFile

获取或设置 IStorageFile 对象，该对象用于表示要由提供保存位置的应用保存的文件。

方法

GetDeferral()

获取提供保存位置的应用可用于异步响应 TargetFileRequested 事件的 TargetFileRequestDeferral。