StorageFolder 類別

定義

命名空間:

Windows.Storage

管理資料夾及其內容，並提供其相關資訊。

public ref class StorageFolder sealed : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolder final : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolder : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

Public NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

繼承

Object Platform::Object IInspectable StorageFolder

屬性

ContractVersionAttribute

實作

IStorageFolder IStorageFolder2 IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IStorageFolderQueryOperations

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能	documentsLibrary musicLibrary picturesLibrary videosLibrary

備註

一般而言，您會取得 StorageFolder 物件做為非同步方法呼叫的傳回值。 例如，靜態方法 GetFolderFromPathAsync 會傳回代表指定資料夾的 StorageFolder。

請注意，當您呼叫檔案選擇器讓使用者挑選資料夾時，檔案選擇器會將資料夾傳回為 StorageFolder。

目前沒有 「MoveAsync」 或類似的方法。 移動資料夾的一個簡單實作可能是取得所需的資料夾、將它複製到所需的位置，然後刪除原始檔案夾。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1803	17134	TryGetChangeTracker
2004	19041	GetFolderFromPathForUserAsync

屬性

Attributes	取得目前資料夾的屬性。
DateCreated	取得目前資料夾建立的日期和時間。
DisplayName	取得目前資料夾的使用者易記名稱。
DisplayType	取得資料夾類型的易記描述;例如， JPEG image 。
FolderRelativeId	取得目前資料夾的識別碼。 此識別碼對於包含目前資料夾或檔案群組的查詢結果或 StorageFolder 而言是唯一的，而且可用來區分具有相同名稱的專案。
Name	取得目前資料夾的名稱。
Path	如果路徑可用，則取得檔案系統中目前資料夾的完整路徑。
Properties	取得 物件，這個物件可讓您存取目前資料夾的內容相關屬性。
Provider	取得 StorageProvider 物件，其中包含儲存目前資料夾之服務的相關資訊。

方法

AreQueryOptionsSupported(QueryOptions)	指出目前資料夾是否支援指定的 QueryOptions。
CreateFileAsync(String)	在目前資料夾中建立具有指定名稱的新檔案。
CreateFileAsync(String, CreationCollisionOption)	在目前資料夾中建立新的檔案。 這個方法也會指定如果具有相同名稱的檔案已存在於目前資料夾中，該怎麼辦。
CreateFileQuery()	取得查詢結果物件，其中包含目前資料夾中的檔案。
CreateFileQuery(CommonFileQuery)	取得查詢結果物件，其中包含目前資料夾中的檔案。 此外，當 查詢 引數的值不是 CommonFileQuery.DefaultQuery時，也會從目前資料夾的子資料夾取得檔案。 檔案會根據指定的 CommonFileQuery排序。
CreateFileQueryWithOptions(QueryOptions)	取得查詢結果物件，其中包含目前資料夾中的檔案，以及選擇性地在目前資料夾的子資料夾中。 結果是以指定的 QueryOptions為基礎。
CreateFolderAsync(String)	使用目前資料夾中的指定名稱建立新的子資料夾。
CreateFolderAsync(String, CreationCollisionOption)	使用目前資料夾中的指定名稱建立新的子資料夾。 如果同名的子資料夾已經存在目前資料夾中，這個方法也會指定該怎麼做。
CreateFolderQuery()	取得查詢結果物件，其中包含目前資料夾中的子資料夾。
CreateFolderQuery(CommonFolderQuery)	取得查詢結果物件，其中包含目前資料夾中的子資料夾。 當 query 引數的值不是 CommonFolderQuery.DefaultQuery，取得虛擬資料夾的清單，代表目前資料夾子資料夾中檔案群組的容器。 檔案會根據 CommonFolderQuery 列舉中的指定值，分組到資料夾中。
CreateFolderQueryWithOptions(QueryOptions)	取得查詢結果物件，其中包含目前資料夾中的子資料夾，並選擇性地包含巢狀子資料夾。 結果是以指定的 QueryOptions為基礎。
CreateItemQuery()	取得查詢結果物件，其中包含目前資料夾中的檔案和子資料夾。
CreateItemQueryWithOptions(QueryOptions)	取得查詢結果物件，其中包含目前資料夾中的檔案和子資料夾，以及目前資料夾子資料夾中選擇性的子資料夾。 結果是以指定的 QueryOptions為基礎。
DeleteAsync()	刪除目前的資料夾。
DeleteAsync(StorageDeleteOption)	刪除目前的資料夾。 這個方法也會指定是否要永久刪除資料夾。
GetBasicPropertiesAsync()	取得目前資料夾或檔案群組的基本屬性。
GetFileAsync(String)	從目前資料夾取得具有指定名稱的檔案。
GetFilesAsync()	取得目前資料夾中的檔案。
GetFilesAsync(CommonFileQuery)	取得目前資料夾中的檔案。 此外，當 查詢 引數的值不是 CommonFileQuery.DefaultQuery時，也會從目前資料夾的子資料夾取得檔案。 檔案會根據 CommonFileQuery 列舉中的指定值排序。
GetFilesAsync(CommonFileQuery, UInt32, UInt32)	從目前資料夾中的所有檔案清單中取得以索引為基礎的檔案範圍。 此外，當 查詢 引數的值不是 CommonFileQuery.DefaultQuery時，也會從目前資料夾的子資料夾取得檔案。 檔案會根據 CommonFileQuery 列舉中的指定值排序。
GetFolderAsync(String)	從目前資料夾取得具有指定名稱的子資料夾。
GetFolderFromPathAsync(String)	取得在檔案系統中具有指定絕對路徑的資料夾。
GetFolderFromPathForUserAsync(User, String)	根據指定使用者檔案系統中的絕對路徑取得 StorageFolder 。
GetFoldersAsync()	取得目前資料夾中的子資料夾。
GetFoldersAsync(CommonFolderQuery)	取得目前資料夾中的子資料夾。 當 query 引數的值不是 CommonFolderQuery.DefaultQuery，取得虛擬資料夾的清單，代表目前資料夾子資料夾中檔案群組的容器。 檔案會根據 CommonFolderQuery 列舉中的指定值，分組到資料夾中。
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)	從目前資料夾中的所有子資料夾清單中取得資料夾的索引型範圍。 當 query 引數的值不是 CommonFolderQuery.DefaultQuery，取得虛擬資料夾的清單，代表目前資料夾子資料夾中檔案群組的容器。 檔案會根據 CommonFolderQuery 列舉中的指定值，分組到資料夾中。
GetIndexedStateAsync()	取得目前資料夾的索引狀態。
GetItemAsync(String)	從目前資料夾取得具有指定名稱的檔案或資料夾。
GetItemsAsync()	取得目前資料夾中的檔案和子資料夾。
GetItemsAsync(UInt32, UInt32)	從目前資料夾中的所有檔案和子資料夾清單中，取得以索引為基礎的檔案和資料夾範圍。
GetParentAsync()	取得目前資料夾的父資料夾。
GetScaledImageAsThumbnailAsync(ThumbnailMode)	取得縮放影像做為縮圖，由縮圖的用途決定。
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	取得縮放影像做為縮圖，取決於縮圖的目的和要求的大小。
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	取得縮放影像做為縮圖，取決於縮圖的目的、要求的大小和指定的選項
GetThumbnailAsync(ThumbnailMode)	取得目前資料夾的縮圖影像，其大小為縮圖的指定用途。
GetThumbnailAsync(ThumbnailMode, UInt32)	取得目前資料夾的縮圖影像，其大小為縮圖的指定用途，並調整為要求的大小。
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	取得目前資料夾的縮圖影像，其大小為縮圖的指定用途，並使用指定的選項調整為所要求的大小。
IsCommonFileQuerySupported(CommonFileQuery)	指出目前資料夾是否支援指定的 CommonFileQuery。
IsCommonFolderQuerySupported(CommonFolderQuery)	指出目前資料夾是否支援指定的 CommonFolderQuery。
IsEqual(IStorageItem)	指出目前資料夾是否等於指定的資料夾。
IsOfType(StorageItemTypes)	指出目前的 StorageFolder 是否符合指定的 StorageItemTypes 值。
RenameAsync(String)	重新命名目前的資料夾。
RenameAsync(String, NameCollisionOption)	重新命名目前的資料夾，並指定如果具有相同名稱的資料夾已經存在，該怎麼辦。
TryGetChangeTracker()	取得與StorageFolder相關聯的StorageLibraryChangeTracker。
TryGetItemAsync(String)	嘗試從目前資料夾取得具有指定名稱的檔案或資料夾。 如果找不到指定的檔案或資料夾，則傳回 null 而不是引發 FileNotFoundException 。

另請參閱

• StorageFile
• 資料夾列舉範例 (Windows 10)
• 內容索引器範例
• 檔案存取範例
• 檔案搜尋範例