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 文件中。

注解

如果你的应用参与“文件保存选取器”合约，则可以在处理 FileSavePicker 激活事件时使用 fileSavePickerUI 属性访问此对象。

使用 FileSavePickerActivatedEventArgs.FileSavePickerUI 属性检索 fileSavePickerUI 对象。

若要了解如何在用户使用你的应用作为保存位置时为用户创建良好的体验，请参阅 使用选取器打开文件和文件夹。

属性

AllowedFileTypes	获取可保存到提供保存位置的应用的文件类型 (扩展名) 的列表。
FileName	获取要保存的文件的完整文件名，包括文件类型扩展名。 文件名和扩展名由用户指定。
SettingsIdentifier	获取文件选取器当前上下文的标识符。
Title	获取或设置在文件选取器 UI 中显示的标题，该标题标识文件选取器向用户显示的位置。

方法

TrySetFileName(String)

尝试在文件选取器 UI 中设置文件名和扩展名。

事件

FileNameChanged	当用户更改文件名文本框中的文件名或更改文件类型下拉菜单中的扩展名时触发。
TargetFileRequested	当用户提交要保存在文件选取器中的文件时触发。

另请参阅

• ActivationKind
• FileSavePickerUI
• FileSavePickerUI
• 使用选取器打开文件和文件夹
• 文件选取器协定示例