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

備註

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

您的應用程式是儲存位置的提供者，可以藉由呼叫targetFileRequestDeferral.complete來發出其TargetFileRequested事件的非同步回應。 深入瞭解在TargetFileRequestedEventArgs中以非同步方式回應TargetFileRequested事件。

方法

Complete()

指出提供儲存位置的應用程式已完成回應 TargetFileRequested 事件。