Xamarin.Essentials:檔案系統協助程式

FileSystem 類別包含一系列協助程式,用於尋找應用程式的快取和資料目錄,並開啟應用程式套件內的檔案。

開始使用

若要開始使用此 API,請閱讀 入門指南Xamarin.Essentials,以確保連結庫已正確安裝並設定在您的專案中。

使用檔案系統協助程式

在類別中新增 的 Xamarin.Essentials 參考:

using Xamarin.Essentials;

取得應用程式的目錄來儲存快取資料。 快取資料可用於需要比暫存資料持續更長時間的任何資料,但不應該是正常運作所需的資料,因為 OS 會指示清除此儲存體的時機。

var cacheDir = FileSystem.CacheDirectory;

取得任何非使用者資料檔案之檔案的應用程式最上層目錄。 這些檔案會使用作業系統同步處理架構進行備份。 請參閱以下平台實作細節。

var mainDir = FileSystem.AppDataDirectory;

如果您想要開啟已配套至應用程式套件的檔案,您可以使用 OpenAppPackageFileAsync 方法來讀取內容。 在下列範例中,名為 mybundledfile.txt 的檔案已新增至每個平臺。 如需詳細資訊,請參閱平臺實作細節一節。

 var fileName = "mybundledfile.txt";
 using (var stream = await FileSystem.OpenAppPackageFileAsync(fileName))
 {
    using (var reader = new StreamReader(stream))
    {
        var fileContents = await reader.ReadToEndAsync();
    }
 }

平台實作特性

  • CacheDirectory – 傳回目前內容的 CacheDir
  • AppDataDirectory – 傳回目前內容的 FilesDir,並使用從 API 23 及更新版本開始的自動備份來進行備份。

將任何檔案新增至 Android 專案的 [資產] 資料夾中,並將建置動作標記為 AndroidAsset,以將其與 OpenAppPackageFileAsync 搭配使用。

API

Channel 9YouTube 上尋找更多 Xamarin 影片。