KnownFolders 类

定义

命名空间:

Windows.Storage

提供对包含用户内容的公共位置的访问。 这包括用户本地库 (的内容，例如文档、图片、音乐和视频) 、家庭组、可移动设备和媒体服务器设备。

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

继承

Object Platform::Object IInspectable KnownFolders

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

文件访问示例演示如何使用 PicturesLibrary 属性在图片库中创建新文件。

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

CreateFileAsync 方法完成后，file变量包含一个代表新文件的 StorageFile。

注解

此类是静态的，无法实例化。 直接访问其属性，如以下示例所示。

• StorageFolder storageFolder = KnownFolders.PicturesLibrary;

先决条件

若要访问此类属性表示的文件夹和库，请在应用清单中指定相应的功能。 例如，若要访问 KnownFolders.PicturesLibrary，请在应用清单中指定 图片库 功能。 在 应用功能声明中详细了解功能。

返回值

KnownFolders 类的属性返回 StorageFolder。 若要使用已知文件夹及其内容，请调用 StorageFolder 类的方法和属性。

• 有关如何在应用中使用图片、音乐和视频的信息，请参阅 音频、视频和相机。
• 有关如何使用文件和文件夹的一般信息，请参阅 枚举和查询文件和文件夹。

更多信息

下面介绍如何访问其他一些常用位置。

• 从 Windows.Storage.ApplicationData.Current.LocalFolder 属性获取应用的本地文件夹。
• 从 Windows.ApplicationModel.Package.Current.InstalledLocation 属性获取应用的安装文件夹。

若要详细了解应用可以访问的位置，请参阅 文件访问权限。

版本历史记录

Windows 版本	SDK 版本	已添加值
1511	10586	GetFolderForUserAsync
2004	19041	GetFolderAsync
2004	19041	RequestAccessAsync
2004	19041	RequestAccessForUserAsync

属性

AppCaptures	获取应用捕获文件夹。
CameraRoll	获取本机照片文件夹。
DocumentsLibrary	获取文档库。 文档库不用于常规用途。
HomeGroup	获取家庭组文件夹。
MediaServerDevices	获取 DLNA（数字生活网络联盟）媒体服务器设备文件夹。
MusicLibrary	获取音乐库。
Objects3D	获取 3D 对象文件夹。
PicturesLibrary	获取图片库。
Playlists	获取播放列表文件夹。
RecordedCalls	获取录制的通话文件夹。
RemovableDevices	获取可移动设备文件夹。
SavedPictures	获取保存的图片文件夹。
VideosLibrary	获取视频库。

方法

GetFolderAsync(KnownFolderId)	检索指定的 folderId 的文件夹。
GetFolderForUserAsync(User, KnownFolderId)	为 用户返回指定已知文件夹的静态方法。
RequestAccessAsync(KnownFolderId)	请求访问控制对文件夹访问权限的功能。
RequestAccessForUserAsync(User, KnownFolderId)	请求访问用户和 folderId。

另请参阅

• StorageFile
• StorageFolder
• Windows.Storage.Search
• 文件访问示例
• 文件访问权限
• 枚举和查询文件和文件夹
• 家庭组示例 (Windows 10)