UWP 文件系统接口

UWP 文件系统接口

本文章翻译自 MSDN

UWP 文件系统的相关接口都放在下面三个名称空间中：
Windows.Storage
Windows.Storage.Streams
Windows.Storage.Pickers

文件访问权限

在 UWP 平台中，程序对文件的访问受到了限制。默认情况下，程序仅能访问少数几个特定位置。如果要访问其他位置，需要通过 file picker 或者在 manifest 中声明权限才行。

程序默认可以访问的位置

你的 app 无需做任何操作就可以访问下面几个位置：

• 程序安装目录
  访问程序安装目录主要有两个方法：
  1. 通过 Package.Current.InstalledLocation 获取 StorageFolder：

Windows.Storage.StorageFolder installedLocation = Windows.ApplicationModel.Package.Current.InstalledLocation;

2. 通过 app URI 获取 StorageFile：

StorageFile file = await StorageFile.GetFileFromApplicationUriAsync("ms-appx:///file.txt");

"ms-appx:///" 前缀就代表程序安装目录，具体可以参考How to use URIs to reference content

程序安装目录是 只读 目录，并且无法通过 file picker 获取。

• 程序的数据区
  给程序存储数据用的文件夹。这些文件夹(local, roaming and temporary)会在程序安装时创建。
  访问程序的数据区主要有两个方法：
  1. 通过 ApplicationData.Current.LocalFolder 获取 StorageFolder：

StorageFolder localFolder = ApplicationData.Current.LocalFolder;

除了 LocalFolder 属性，还可以使用 RoamingFolder 或 TemporaryFolder 属性来获取其他文件夹。
要了解更多关于 app data locations 的使用方法，可以参考 Managing application data

2. 通过 app URI 获取 StorageFile：

StorageFile file = await StorageFile.GetFileFromApplicationUriAsync("ms-appdata:///local/file.txt");

"ms-appdata:///local/" 前缀就代表 LocalFolder，还可以使用 "ms-appdata:///roaming/" 或 "ms-appdata:///temporary/" 来获取另外两个文件夹。要了解 app URIs 的更多知识，具体可以参考：How to load file resources

程序数据区是 可读写 目录，并且无法通过 file picker 获取。

• 可插拔设备

枚举文件和文件夹

// 获取图片文件夹所在的 StorageFolder
StorageFolder picFolder = KnownFolders.PicturesLibrary;

// 获取图片文件夹下所有文件(不会递归子目录)
IReadOnlyList fileList = await picFolder.GetFilesAsync();

// 获取图片文件夹下所有子文件夹(不会递归子目录)
IReadOnlyList folderList = await picFolder.GetFoldersAsync();

// 获取图片文件夹下所有子项(不会递归子目录)
IReadOnlyList itemList = await picFolder.GetItemsAsync();

// 获取图片文件夹中名为 Screenshots 的文件夹
IStorageItem item = await picFolder.TryGetItemAsync("Screenshots");
if (item != null && item is StorageFolder)
{
    StorageFolder screenshotsFolder = item as StorageFolder;
}

// 查询图片文件夹下所有 .png 文件(递归子目录)
QueryOptions queryOptions = new QueryOptions();
queryOptions.FileTypeFilter.Add(".png");
queryOptions.FolderDepth = FolderDepth.Deep;
StorageFileQueryResult queryResult = picFolder.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList queryFileList = await queryResult.GetFilesAsync();

注意 使用以上代码前，要先在 Package.appxmanifest 里添加图片库的访问权限。