Xamarin.Essentials:文件系统帮助程序

FileSystem 类包含一系列帮助程序,用于查找应用程序的缓存和数据目录以及打开应用包内的文件。

入门

若要开始使用此 API,请阅读 Xamarin.Essentials 的入门指南,确保在项目中正确安装和设置库。

使用文件系统帮助程序

在类中添加对 Xamarin.Essentials 的引用:

using Xamarin.Essentials;

获取应用程序的目录以存储缓存数据。 缓存数据可用于满足以下要求的任何数据:需要比临时数据持续更长时间,但不应是正确执行操作所需的数据,因为操作系统将指示何时清除此存储。

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 项目中的 Assets 文件夹中,并将生成操作标记为 AndroidAsset 以将其与 OpenAppPackageFileAsync 一起使用 。

API

第 9 频道YouTube 上查找更多 Xamarin 视频。