KnownFolders Class

Definition

public ref class KnownFolders abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFolders

Public Class KnownFolders

Inheritance

Object Platform::Object IInspectable KnownFolders

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Examples

The File access sample shows you how to use the PicturesLibrary property to create a new file in the Pictures library.

StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.

After the CreateFileAsync method completes, the file variable contains a StorageFile that represents the new file.

Remarks

This class is static and cannot be instantiated. Access its properties directly, as shown in the following example.

• StorageFolder storageFolder = KnownFolders.PicturesLibrary;

Prerequisites

To access the folders and libraries represented by the properties of this class, specify the corresponding capabilities in your app manifest. For example, to access KnownFolders.PicturesLibrary, specify the Pictures Library capability in the app manifest. Learn more about capabilities in App capability declarations.

Return value

The properties of the KnownFolders class return a StorageFolder. To work with the known folder and its contents, call the methods and properties of the StorageFolder class.

• For info about how to use pictures, music, and videos in your app, see Audio, video, and camera.
• For general info about how to use files and folders, see Enumerate and query files and folders.

More info

Here's how to access some other commonly used locations.

• Get the app's local folder from the Windows.Storage.ApplicationData.Current.LocalFolder property.
• Get the app's installation folder from the Windows.ApplicationModel.Package.Current.InstalledLocation property.

To learn more about the locations that your app can access, see File access permissions.

Version history

Properties

Methods

Applies to

See also

• StorageFile
• StorageFolder
• Windows.Storage.Search
• File access sample
• File access permissions
• Enumerate and query files and folders
• HomeGroup sample (Windows 10)