通过

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 版本 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。

适用于

另请参阅