FileSavePickerUI.TargetFileRequested 事件

定义

当用户提交要保存在文件选取器中的文件时触发。

// Register
event_token TargetFileRequested(TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void TargetFileRequested(event_token const* cookie) const;

// Revoke with event_revoker
FileSavePickerUI::TargetFileRequested_revoker TargetFileRequested(auto_revoke_t, TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs const&> const& handler) const;
public event TypedEventHandler<FileSavePickerUI,TargetFileRequestedEventArgs> TargetFileRequested;
function onTargetFileRequested(eventArgs) { /* Your code */ }
fileSavePickerUI.addEventListener("targetfilerequested", onTargetFileRequested);
fileSavePickerUI.removeEventListener("targetfilerequested", onTargetFileRequested);
- or -
fileSavePickerUI.ontargetfilerequested = onTargetFileRequested;
Public Custom Event TargetFileRequested As TypedEventHandler(Of FileSavePickerUI, TargetFileRequestedEventArgs) 

事件类型

示例

文件选取器示例演示如何响应 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 中响应此事件。

注意

文件选取器 UI 处于禁用状态,直到提供的应用完成对此事件的响应。

适用于

另请参阅