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
搭配使用。