FolderPicker Class

Definition

Namespace:: Windows.Storage.Pickers

Edit

Represents a UI element that lets the user choose folders.

public ref class FolderPicker sealed

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FolderPicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
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.Static(Windows.Storage.Pickers.IFolderPickerStatics, 524288, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FolderPicker sealed

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

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

[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.Static(typeof(Windows.Storage.Pickers.IFolderPickerStatics), 524288, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FolderPicker

function FolderPicker()

Public NotInheritable Class FolderPicker

Inheritance: Object
FolderPicker

Attributes: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute StaticAttribute ThreadingAttribute

Windows 10 requirements

Device family	Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

To get started accessing files and folders with a picker, see Open files and folders with a picker.

Version history

Windows version	SDK version	Value added
1903	18362	CreateForUser
1903	18362	User

Constructors

FolderPicker()

Creates a new instance of a FolderPicker.

Properties

CommitButtonText	Gets or sets the label text of the folder picker's commit button.
ContinuationData	Gets a set of values to be populated by the app before a PickFolderAndContinue operation that deactivates the app in order to provide context when the app is activated. (Windows Phone 8.x app)
FileTypeFilter	Gets the collection of file types that the folder picker displays.
SettingsIdentifier	Gets or sets the settings identifier associated with the with the current FolderPicker instance.
SuggestedStartLocation	Gets or sets the initial location where the folder picker looks for folders to present to the user.
User	Gets info about the user for which the FolderPicker was created. Use this property for multi-user applications.
ViewMode	Gets or sets the view mode that the folder picker uses to display items.

Methods

CreateForUser(User)	Creates a FolderPicker that is scoped to the personal directory of the specified user. Use this method for multi-user applications.
PickFolderAndContinue()	Obsolete as of Windows 10; use PickSingleFolderAsync instead. Shows the file picker so that the user can pick a folder, deactivating and the app and reactivating it when the operation is complete. (Windows Phone 8.x app)
PickSingleFolderAsync()	Shows the folderPicker object so that the user can pick a folder. (UWP app) Note You must specify the FileTypeFilter before calling this method, or it will throw an exception. To list all folders, use "*" as the filter.

Applies to