共用方式為

使用 Windows 應用程式 SDK 的檔案、資料夾和程式庫

  • 發行項

封裝的 Windows 應用程式 SDK 應用程式可利用 Windows.Storage、Windows.Storage.Streams 和 Windows.Storage.Pickers 命名空間所提供的強大 API，有效率地讀取和寫入檔案中的各種資料格式，以及管理檔案和資料夾。 本節涵蓋基本主題，例如讀取和寫入應用程式設定、檔案和資料夾選擇器，以及存取視訊/音樂媒體櫃等特殊沙箱位置。 了解如何使用 Windows 應用程式 SDK 將應用程式的檔案管理功能最佳化。

Windows 10 和更新版本的 OS 版本提供與應用程式的檔案、資料夾、程式庫和設定相關的各種 API。 您可透過 Windows SDK 和 .NET SDK 所提供的 WinRT 和 .NET API 組合來取得這些功能。

使用 WinRT 儲存體 API 讀取和寫入資料

已封裝的應用程式可以存取 UWP 應用程式可用的所有 WinRT 儲存體 API。 無論您是移轉現有的 UWP 應用程式或建立新的應用程式，都可以使用這些 API 來讀取和寫入資料。 如需在 WinUI 應用程式中使用儲存體 API 的範例，請參閱使用 Windows 應用程式 SDK 和 WinRT API 存取檔案和資料夾。

使用 .NET 檔案 API 讀取和寫入資料

除了 WinRT API 之外，封裝的應用程式也可以使用 System.IO 命名空間中的 .NET API 來讀取和寫入資料。 建立新的 WinUI 3 專案時，其 Package.appxmanifest 檔案會包含下列設定：

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

宣告此受限制的功能可提供檔案系統、登錄和其他受限制功能的完整存取權。 如需詳細資訊，請參閱受限制的功能宣告。 換句話說，當使用 .NET 檔案 API 時，應用程式具有與任何其他 .NET 傳統型應用程式相同的檔案系統存取權。

如需在 WinUI 應用程式中使用 .NET API 的範例，請參閱使用 Windows 應用程式 SDK 和 .NET API 存取檔案和資料夾。

使用檔案和資料夾的其他資源

如果您正在開發封裝的 WinUI 應用程式，則 WinRT 儲存體 API 可以做為讀取和寫入資料的強大工具。 下列 UWP 主題可為想要在其應用程式中運用這些 API 的開發人員提供豐富的資訊。

主題 說明
列舉和查詢檔案和資料夾 存取位於資料夾、媒體櫃、裝置或網路位置中的檔案和資料夾。 您也可以建構檔案和資料夾查詢，以查詢位置中的檔案和資料夾。
建立、寫入和讀取檔案 使用 StorageFile 物件讀取和寫入檔案。
寫入檔案的最佳做法 了解使用 FileIO 和 PathIO 類別的各種檔案寫入方法的最佳做法。
取得檔案屬性 取得由 StorageFile 物件所表示檔案的屬性 (最上層、基本及延伸)。
使用選擇器開啟檔案和資料夾 讓使用者與選擇器互動以存取檔案和資料夾。 您可以使用 FolderPicker 來存取資料夾。

注意：在桌面應用程式中 (包含 WinUI 3 應用程式)，您可以使用 Windows.Storage.Pickers 中的檔案和資料夾選擇器。 不過，如果桌面應用程式需要提升權限才能執行，您將需要不同的方法，因為這些 API 並非設計用於提升權限的應用程式。 如需範例，請參閱 FileSavePicker。
使用選擇器儲存檔案 使用 FileSavePicker 讓使用者指定他們想要您的應用程式儲存檔案的名稱和位置。
存取 HomeGroup 內容 存取儲存在使用者 HomeGroup 資料夾中的內容，包括圖片、音樂及視訊。
判斷 Microsoft OneDrive 檔案的可用性 判斷 Microsoft OneDrive 檔案是否可使用 StorageFile.IsAvailable 屬性。
音樂、圖片及影片媒體櫃中的檔案和資料夾 將現有的音樂、圖片或影片資料夾新增至對應的文件庫。 您也可以從媒體櫃中移除資料夾、取得媒體櫃中的資料夾清單，以及尋找已儲存的相片、音樂和影片。
追蹤最近使用的檔案和資料夾 將檔案新增至您應用程式最近使用的清單 (MRU)，以追蹤使用者經常存取的檔案。 平台會根據上次存取項目的時間排序項目，並在達到清單的 25 個項目限制時移除最舊的項目，以為您管理 MRU。 所有應用程式都有自己的 MRU。
追蹤在背景中的檔案系統變更 追蹤檔案系統變更，即使應用程式未執行時亦然。
存取 SD 記憶卡 您可以在選用的 microSD 記憶卡上儲存和存取非必要的資料，尤其是內部儲存空間有限的低價行動裝置。
快速存取檔案屬性 有效收集程式庫的檔案和其屬性清單以便透過 Windows 執行階段 API 使用。

另請參閱

使用 Windows 應用程式 SDK 和 WinRT API 存取檔案和資料夾

使用 Windows 應用程式 SDK 和 .NET API 存取檔案和資料夾

System.IO