KnownFolders 類別

定義

命名空間:

Windows.Storage

提供包含使用者內容之常見位置的存取權。 這包括使用者本機媒體櫃的內容， (例如檔、圖片、音樂和影片) 、HomeGroup、卸載式裝置和媒體伺服器裝置。

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	取得相機 Roll 資料夾。
DocumentsLibrary	取得文件庫。 文件庫不適用於一般用途。
HomeGroup	取得 HomeGroup 資料夾。
MediaServerDevices	取得媒體伺服器 (Digital Living Network Alliance (DLNA) ) 裝置的資料夾。
MusicLibrary	取得音樂媒體櫃。
Objects3D	取得 Objects 3D 資料夾。
PicturesLibrary	取得圖片媒體櫃。
Playlists	取得播放清單資料夾。
RecordedCalls	取得錄製的呼叫資料夾。
RemovableDevices	取得卸載式裝置資料夾。
SavedPictures	取得 [已儲存的圖片] 資料夾。
VideosLibrary	取得影片庫。

方法

GetFolderAsync(KnownFolderId)	擷取所指定 folderId 的資料夾。
GetFolderForUserAsync(User, KnownFolderId)	靜態方法，會傳回 User的指定已知資料夾。
RequestAccessAsync(KnownFolderId)	要求存取權，以控制資料夾的存取權。
RequestAccessForUserAsync(User, KnownFolderId)	要求使用者和 folderId 的存取權。

另請參閱

• StorageFile
• StorageFolder
• Windows.Storage.Search
• 檔案存取範例
• 檔案存取權限
• 列舉和查詢檔案和資料夾
• HomeGroup 範例 (Windows 10)