UWP 文件系统接口
本文章翻译自 MSDN
UWP 文件系统的相关接口都放在下面三个名称空间中：
Windows.Storage
Windows.Storage.Streams
Windows.Storage.Pickers
文件访问权限
在 UWP 平台中，程序对文件的访问受到了限制。默认情况下，程序仅能访问少数几个特定位置。如果要访问其他位置，需要通过 file picker 或者在 manifest 中声明权限才行。
程序默认可以访问的位置
你的 app 无需做任何操作就可以访问下面几个位置：
-
程序安装目录
访问程序安装目录主要有两个方法：- 通过 Package.Current.InstalledLocation 获取 StorageFolder：
Windows.Storage.StorageFolder installedLocation = Windows.ApplicationModel.Package.Current.InstalledLocation;
- 通过 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)会在程序安装时创建。
访问程序的数据区主要有两个方法：- 通过 ApplicationData.Current.LocalFolder 获取 StorageFolder：
StorageFolder localFolder = ApplicationData.Current.LocalFolder;
除了 LocalFolder 属性，还可以使用 RoamingFolder 或 TemporaryFolder 属性来获取其他文件夹。
要了解更多关于 app data locations 的使用方法，可以参考 Managing application data
- 通过 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<StorageFile> fileList = await picFolder.GetFilesAsync();
// 获取图片文件夹下所有子文件夹(不会递归子目录)
IReadOnlyList<StorageFolder> folderList = await picFolder.GetFoldersAsync();
// 获取图片文件夹下所有子项(不会递归子目录)
IReadOnlyList<IStorageItem> 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<StorageFile> queryFileList = await queryResult.GetFilesAsync();
注意 使用以上代码前，要先在 Package.appxmanifest 里添加图片库的访问权限。
