跟踪最近使用的文件和文件夹

项目
07/13/2023

重要的 API

通过将用户经常访问的文件添加到你的应用的最近使用列表 (MRU) 中来跟踪这些文件。该平台会为你管理 MRU，它会根据各个项的上次访问时间对它们进行排序，并在列表中的项超过 25 个的限制时删除最旧的项。所有应用都有其各自的 MRU。

你的应用的 MRU 由 StorageItemMostRecentlyUsedList 类表示，你可从静态 StorageApplicationPermissions.MostRecentlyUsedList 属性获取该类。 MRU 项存储为 IStorageItem 对象，这意味着 StorageFile 对象（代表文件）和 StorageFolder 对象（代表文件夹）都可以添加到 MRU 中。

注意

有关完整示例，请参阅文件选取器示例和文件访问示例。

必备条件

了解通用 Windows 平台 (UWP) 应用的异步编程

若要了解如何使用 C# 或 Visual Basic 编写异步应用，请参阅使用 C# 或 Visual Basic 调用异步 API。若要了解如何使用 C++ 编写异步应用，请参阅使用 C++ 进行异步编程。
对位置的访问权限

请参阅文件访问权限。
使用选取器打开文件和文件夹

选取的文件通常是用户再三返回查看的文件。

向 MRU 中添加选取的文件

用户选取的文件通常是他们重复返回的文件。因此，当选取文件时，请考虑将选取的文件添加到你的应用的 MRU。操作方法如下。
```
Windows.Storage.StorageFile file = await picker.PickSingleFileAsync();

var mru = Windows.Storage.AccessCache.StorageApplicationPermissions.MostRecentlyUsedList;
string mruToken = mru.Add(file, "profile pic");
```
将重载 StorageItemMostRecentlyUsedList.Add。此示例中使用了 Add(IStorageItem, String)，这样便可将元数据与文件关联。设置元数据可以记录项目的用途，例如“用户头像”。你还可以通过调用 Add(IStorageItem) 将文件添加到不包含元数据的 MRU 中。当你向 MRU 中添加项时，该方法会返回一个唯一标识的字符串（称为令牌），用于检索该项。

提示

需要使用该令牌从 MRU 中检索项，因此请将它保留在某处。有关应用数据的详细信息，请参阅管理应用程序数据。

使用令牌从 MRU 检索项

使用最适合希望检索的项的检索方法。

使用 GetFileAsync 检索作为 StorageFile 的文件。
使用 GetFolderAsync 检索作为 StorageFolder 的文件夹。
使用 GetItemAsync 检索既可代表文件也可代表文件夹的通用 IStorageItem。

这里介绍了如何取回我们刚刚添加的文件。

StorageFile retrievedFile = await mru.GetFileAsync(mruToken);

这里介绍了如何进行迭代以获取令牌，然后获取项。

foreach (Windows.Storage.AccessCache.AccessListEntry entry in mru.Entries)
{
    string mruToken = entry.Token;
    string mruMetadata = entry.Metadata;
    Windows.Storage.IStorageItem item = await mru.GetItemAsync(mruToken);
    // The type of item will tell you whether it's a file or a folder.
}

使用 AccessListEntryView 可以迭代 MRU 中的条目。这些条目是包含项的令牌和元数据的 AccessListEntry 结构。

当 MRU 已满时从中删除项

当达到 MRU 的 25 项这一限制并尝试添加新项时，会自动删除最早访问的项。因此，添加新项之前无需删除任何项。

未来访问列表

除了 MRU，你的应用还具有一个未来访问列表。通过选择文件和文件夹，你的用户向你的应用授予访问项的权限（若未授权可能无法访问）。如果将这些项添加到你的未来访问列表，然后当你的应用需要以后重新访问这些项时将保留该权限。你的应用的未来访问列表由 StorageItemAccessList 类表示，你能从静态 StorageApplicationPermissions.FutureAccessList 属性获取该类。

当用户选取一个项时，请考虑将它添加到你的未来访问列表以及 MRU 中。

FutureAccessList 最多可保留 1000 个项。请记住：它可以保留文件夹以及文件，所以有很多文件夹。
平台永远不会为你从 FutureAccessList 删除项。当你达到 1000 个项的限制时，你就无法添加另一个项，直到你采用 Remove 方法腾出空间。

通过