FileSavePickerUI 類別

定義

命名空間:

Windows.Storage.Pickers.Provider

當您的應用程式使用檔案儲存選擇器合約提供儲存位置時，用來與檔案選擇器互動。

public ref class FileSavePickerUI sealed

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

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

Public NotInheritable Class FileSavePickerUI

繼承

Object Platform::Object IInspectable FileSavePickerUI

屬性

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 引進)

範例

檔案選擇器範例示範如何回應FileSavePicker啟動的事件。

// fileSavePicker activated event handler
protected override void OnFileSavePickerActivated(FileSavePickerActivatedEventArgs args)
{
    var FileSavePickerPage = new SDKTemplate.FileSavePickerPage();
    FileSavePickerPage.Activate(args);
}

// Overloaded method to respond to fileSavePicker events
internal void Activate(FileSavePickerActivatedEventArgs args)
{
    // Perform tasks to prepare your app to display its file picker page

    // Get file picker UI
    fileSavePickerUI = args.FileSavePickerUI;

    Window.Current.Content = this;
    this.OnNavigatedTo(null);
    Window.Current.Activate();
}

針對 C#， args 包含 FileSavePickerActivatedEventArgs 物件。 此外， OnFileSavePickerActivated 位於 App.xaml.cs 檔案中， Activate 而 方法位於 檔案選擇器範例的 FileSavePickerPage.xaml.cs 檔案中。

備註

如果您的 app 參與檔案儲存選擇器合約，您可以在處理 FileSavePicker 啟動事件時，使用 fileSavePickerUI 屬性來存取此物件。

使用 FileSavePickerActivatedEventArgs.FileSavePickerUI 屬性來擷取 fileSavePickerUI 物件。

若要瞭解如何在使用您的應用程式作為儲存位置時為使用者建立良好的體驗，請參閱 使用選擇器開啟檔案和資料夾。

屬性

AllowedFileTypes	取得 (副檔名的檔案類型清單，) 可儲存至提供儲存位置的應用程式。
FileName	取得要儲存之檔案的完整檔案名，包括副檔名。 檔案名和副檔名是由使用者指定。
SettingsIdentifier	取得檔案選擇器目前內容的識別碼。
Title	取得或設定要在檔案選擇器 UI 中顯示的標題，以識別檔案選擇器向使用者顯示的位置。

方法

TrySetFileName(String)

嘗試在檔案選擇器 UI 中設定檔案名和副檔名。

事件

FileNameChanged	當使用者在 [檔案名] 文字方塊中變更檔案名，或變更檔案類型下拉式功能表中的副檔名時引發。
TargetFileRequested	當使用者認可要儲存在檔案選擇器中的檔案時引發。

另請參閱

• ActivationKind
• FileSavePickerUI
• FileSavePickerUI
• 使用選擇器開啟檔案和資料夾
• 檔案選擇器合約範例