FolderPicker 类

定义

命名空间:

Windows.Storage.Pickers

表示允许用户选择文件夹的 UI 元素。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

public ref class FolderPicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FolderPicker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FolderPicker

function FolderPicker()

Public NotInheritable Class FolderPicker

继承

Object Platform::Object IInspectable FolderPicker

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 中引入)

注解

若要开始使用选取器访问文件和文件夹，请参阅 使用选取器打开文件和文件夹。

版本历史记录

Windows 版本	SDK 版本	增值
1903	18362	CreateForUser
1903	18362	用户

构造函数

FolderPicker()

创建 FolderPicker 的新实例。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将 对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow 的 WinRT UI 对象。

属性

CommitButtonText	获取或设置文件夹选取器提交按钮的标签文本。
ContinuationData	获取一组在 PickFolderAndContinue 操作之前由应用填充的值，该操作停用应用，以便在激活应用时提供上下文。 (Windows Phone 8.x 应用)
FileTypeFilter	获取文件夹选取器显示的文件类型的集合。
SettingsIdentifier	获取或设置与当前 FolderPicker 实例关联的设置标识符。
SuggestedStartLocation	获取或设置文件夹选取器查找要呈现给用户的文件夹的初始位置。
User	获取有关为其创建了 FolderPicker 的用户的信息。 将此属性用于 多用户应用程序。
ViewMode	获取或设置文件夹选取器用于显示项的视图模式。

方法

CreateForUser(User)	创建一个 FolderPicker ，该文件夹的范围限定为指定用户的个人目录。 将此方法用于 多用户应用程序。
PickFolderAndContinue()	自 Windows 10 起已过时;请改用 PickSingleFolderAsync。 显示文件选取器，以便用户可以选取文件夹、停用和应用，并在操作完成时重新激活它。 (Windows Phone 8.x 应用)
PickSingleFolderAsync()	显示 folderPicker 对象，以便用户可以选取文件夹。 (UWP 应用) 注意 在调用此方法之前，必须指定 FileTypeFilter ，否则它将引发异常。 若要列出所有文件夹，请使用“*”作为筛选器。

另请参阅

• 文件选取器示例
• 显示依赖于 CoreWindow 的 WinRT UI 对象