FileSavePickerUI.TargetFileRequested 事件

定義

命名空間:

Windows.Storage.Pickers.Provider

當使用者認可要儲存在檔案選擇器中的檔案時引發。

// 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) 

事件類型

TypedEventHandler<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 物件。

備註

如果您的 app 參與檔案儲存選擇器合約，並引發 TargetFileRequested 事件，您的應用程式應該建立新的 StorageFile ，代表使用者想要儲存的檔案。 您所建立的 StorageFile 名稱必須符合 FileName 屬性所指定的檔案名。 您建立的 StorageFile 會傳回至呼叫端應用程式 (呼叫應用程式) 呼叫的應用程式，讓呼叫端應用程式可以將內容寫入檔案。 深入瞭解如何在 targetFileRequestedEventArgs中回應此事件。

注意

檔案選擇器 UI 會停用，直到提供的應用程式完成回應此事件為止。

另請參閱

• FileSavePickerUI
• TargetFileRequestedEventArgs
• StorageFile