Windows.Storage 命名空間

提供用於管理檔案、資料夾和應用程式設定的類別。

關於如何在 Windows 中使用這些物件的資訊。儲存命名空間，請參見以下章節。

• 檔案、資料夾和媒體櫃
• 儲存及擷取設定和其他應用程式資料

類別

名稱	Description
AppDataPaths	AppDataPaths 會根據 KNOWNFOLDERID 命名模式，回傳常用應用程式資料夾的路徑。
ApplicationData	提供應用程式資料儲存庫的存取權限。 應用程式資料由本地、漫遊或暫時的檔案與設定組成。
ApplicationDataCompositeValue	代表必須原子序列化與反序列化的相關應用程式設定。
ApplicationDataContainer	代表一個用於應用程式設定的容器。 此類別的方法與屬性支援建立、刪除、列舉及遍歷容器階層結構。
ApplicationDataContainerSettings	提供設定容器中的設定存取權限。 ApplicationDataContainer.Values 屬性會回傳一個可被鑄造為此類型的物件。
CachedFileManager	讓應用程式管理檔案的即時更新。
DownloadsFolder	在 Downloads 資料夾內建立檔案和資料夾。
FileIO	提供輔助方法，用於讀取與寫入以 IStorageFile 類型的物件表示的檔案。
KnownFolders	提供包含使用者內容的常見位置存取。 這包括使用者本地資料庫的內容（如文件、圖片、音樂和影片）、HomeGroup、可移動裝置以及媒體伺服器裝置。
PathIO	提供輔助方法，利用檔案的絕對路徑或統一資源識別碼（URI）來讀寫檔案。
SetVersionDeferral	管理延遲設定版本操作。
SetVersionRequest	當應用程式設定應用程式資料版本於其應用程式資料儲存庫時，會提供資料。
StorageFile	表示檔案。 提供關於檔案及其內容的資訊，以及操作方法。
StorageFolder	管理資料夾及其內容，並提供相關資訊。
StorageLibrary	它讓你可以新增或移除像音樂或影片這類資料庫的資料夾，並且取得資料庫中包含的資料夾清單。
StorageLibraryChange	代表儲存庫中的項目變更，例如文件、音樂或影片庫。
StorageLibraryChangeReader	讓呼叫應用程式能夠讀取儲存庫中項目的變更。
StorageLibraryChangeTracker	提供 API，讓你能管理任何函式庫（如文件、音樂或影片）或資料夾的變更追蹤。
StorageLibraryChangeTrackerOptions	允許來電者在變更追蹤器中呼叫 EnableWithOptions，選擇追蹤所有變更，包括最後變更 ID，或僅追蹤最後變更 ID。
StorageLibraryLastChangeId	允許你根據唯一值追蹤變更，該值代表索引服務對特定 StorageFolder 或 StorageLibrary 最後處理的變更。
StorageProvider	包含儲存檔案和資料夾服務的資訊。 檔案和資料夾可以由本地檔案系統儲存，或由遠端服務（如 Microsoft OneDrive）儲存。
StorageStreamTransaction	代表隨機存取串流的寫入交易。
StreamedFileDataRequest	代表一個序列存取的輸出串流，表示對由呼叫 CreateStreamedFileAsync 或 ReplaceWithStreamedFileAsync 所建立的儲存檔案資料串流的請求。
SystemAudioProperties	一個輔助物件，提供 Windows 音訊檔案屬性的索引名稱。
SystemDataPaths	根據 KNOWNFOLDERID 命名模式，獲得一些常用的系統範圍資料夾位置。
SystemGPSProperties	一個輔助物件，提供 GPS 檔案屬性的索引名稱。
SystemImageProperties	一個輔助物件，提供 Windows 影像檔案屬性的索引名稱。
SystemMediaProperties	一個輔助物件，提供 Windows 媒體檔案屬性的索引名稱。
SystemMusicProperties	一個輔助物件，提供 Windows 音樂檔案屬性的索引名稱。
SystemPhotoProperties	一個輔助物件，提供 Windows 照片檔案屬性的索引名稱。
SystemProperties	提供字串值用於索引常見 Windows 檔案屬性名稱，如 System.Title，並參考提供特定檔案類型屬性索引名稱的輔助物件（例如影片檔案）。
SystemVideoProperties	一個輔助物件，提供 影片檔案屬性的索引名稱。
UserDataPaths	回傳完整路徑以儲存共用使用者資料資料夾。 使用者資料資料夾是基於 KNOWNFOLDERID 命名模式。

介面

名稱	Description
IStorageFile	表示檔案。 提供關於檔案及其內容的資訊，以及操作方式。 Important 如果你只是想在應用程式裡處理檔案，可以參考 StorageFile 類別。
IStorageFile2	表示檔案。 提供關於檔案及其內容的資訊，以及操作方式。 Important 如果你只是想在應用程式裡處理檔案，可以參考 StorageFile 類別。
IStorageFilePropertiesWithAvailability	提供對 IsAvailable 物業的存取權。
IStorageFolder	操作資料夾及其內容，並提供相關資訊。 Important 如果你只是想在應用程式裡處理資料夾，請參考 StorageFolder 類別。
IStorageFolder2	操作資料夾及其內容，並提供相關資訊。 Important 如果你只是想在應用程式裡處理資料夾，請參考 StorageFolder 類別。
IStorageItem	操作儲存項目（檔案與資料夾）及其內容，並提供相關資訊。 Important 如果你只是想在應用程式中處理檔案和資料夾，請參考 StorageFile 和 StorageFolder 類別。
IStorageItem2	操作儲存項目（檔案與資料夾）及其內容，並提供相關資訊。 Important 如果你只是想在應用程式中處理檔案和資料夾，請參考 StorageFile 和 StorageFolder 類別。
IStorageItemProperties	提供存取物品的常見及內容屬性（如檔案和資料夾）。
IStorageItemProperties2	提供將縮放影像作為縮圖的方法存取。
IStorageItemPropertiesWithProvider	提供特定提供者對儲存項目的常見及內容屬性的存取。
IStreamedFileDataRequest	代表一個序列存取的輸出串流，表示對由呼叫 CreateStreamedFileAsync 或 ReplaceWithStreamedFileAsync 所建立的儲存檔案資料串流的請求。

列舉

名稱	Description
ApplicationDataCreateDisposition	指定建立應用程式資料容器或回傳現有容器的選項。 此枚舉由 ApplicationDataContainer.CreateContainer 方法使用。
ApplicationDataLocality	指定應用程式資料儲存的類型。
CreationCollisionOption	當你建立新檔案或資料夾時，指定了該名稱的檔案或資料夾，該怎麼做。
FileAccessMode	指定是以唯讀模式或讀寫模式存取檔案。
FileAttributes	描述檔案或資料夾的屬性。
KnownFolderId	提供識別儲存資料夾的值。
KnownFoldersAccessStatus	描述已知資料夾對單一功能的存取權限。
KnownLibraryId	提供識別儲存函式庫的值。
NameCollisionOption	當你複製、移動或重新命名檔案或資料夾時，指定名稱的檔案或資料夾已存在於目前該資料夾時，該怎麼做。
StorageDeleteOption	指定刪除項目是否移入回收站或永久刪除。
StorageItemTypes	描述實作 IStorageItem 介面的項目是檔案還是資料夾。
StorageLibraryChangeType	描述儲存庫項目所發生的變更類型。
StorageOpenOptions	提供開啟檔案時可用的選項。
StreamedFileFailureMode	說明了資料無法串流的原因。

委派

名稱	Description
ApplicationDataSetVersionHandler	代表一種處理設定應用程式資料版本請求的方法。
StreamedFileDataRequestedHandler	代表當檔案首次被存取時，將資料串流到儲存 檔案 的方法。

備註

備註

應用程式框架相容性：Windows。儲存 API 可用於 Windows 應用程式 SDK（WinUI 3）桌面應用程式及 Win32 桌面應用程式，而非僅限於 UWP 應用程式。 桌面應用程式可以透過 C#/WinRT 或 C++/WinRT 使用 StorageFile、 StorageFolder 和 ApplicationData 等類別。 某些 API（例如檔案選擇器）在未封裝的桌面應用程式中需要額外設定。 詳情請參閱桌面應用程式中的呼叫 Windows 執行階段 API。

另請參閱

• 檔案存取範例（Windows 10）
• 資料夾列舉範例（Windows 10）
• 簡易映像範例（Windows 10）
• 檔案選擇器範例（Windows 10）
• 檔案搜尋範例（Windows 10）
• 檔案與資料夾縮圖範例（Windows 10）
• 函式庫管理範例（Windows 10）
• 背景轉錄樣本
• 背景傳輸範例（Windows 8.x）
• 內容索引器範例
• 資料序列化與反序列化範例
• HomeGroup 範例
• RSS 閱讀器端對端（JavaScript）範例