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

取得 TargetFileRequestDeferral ，提供儲存位置的應用程式可用來以非同步方式回應 TargetFileRequested 事件。