StorageItemMostRecentlyUsedList 类

定义

命名空间:

Windows.Storage.AccessCache

表示应用最近使用的列表 (MRU) (从静态 StorageApplicationPermissions.MostRecentlyUsedList 属性) 获取。 使用 MRU 跟踪用户最近访问的文件和/或文件夹 (项) 。 项作为 StorageFile 和 StorageFolder 对象存储在 MRU 中。

public ref class StorageItemMostRecentlyUsedList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemMostRecentlyUsedList final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemMostRecentlyUsedList

Public NotInheritable Class StorageItemMostRecentlyUsedList

继承

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

属性

ContractVersionAttribute

实现

IStorageItemAccessList

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此示例演示如何将项添加到应用的 FutureAccessList 和 MostRecentlyUsedList。

StorageFile file = await savePicker.PickSaveFileAsync();
if (file != null)
{
    // Add to MRU with metadata (For example, a string that represents the date)
    string mruToken = Windows.Storage.AccessCache.StorageApplicationPermissions.MostRecentlyUsedList.Add(file, "20120716");

    // Add to FA without metadata
    string faToken = Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);  
}
else
{
    // The file picker was dismissed with no file selected to save
}

#include <sstream>
#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Storage.AccessCache.h>
#include <winrt/Windows.Storage.Pickers.h>
using namespace winrt;
using namespace Windows::Storage::Pickers;
using namespace Windows::Storage;
...
winrt::fire_and_forget AddToLists()
{
    FileSavePicker savePicker;
    auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
    plainTextExtensions.Append(L".txt");
    savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
    savePicker.SuggestedFileName(L"New Document");

    StorageFile file{ co_await savePicker.PickSaveFileAsync() };
    if (file)
    {
        // Add to MRU with metadata (For example, a string that represents the date)
        winrt::hstring mruToken { Windows::Storage::AccessCache::StorageApplicationPermissions::MostRecentlyUsedList().Add(file, L"20120716") };

        // Add to FA without metadata
        winrt::hstring faToken { Windows::Storage::AccessCache::StorageApplicationPermissions::FutureAccessList().Add(file) };
    }
    else
    {
        // The file picker was dismissed with no file selected to save
    }
}

建议存储 StorageApplicationPermissions.MostRecentlyUsedList.Add 和 StorageApplicationPermissions.FutureAccessList.Add 返回的令牌，以便可以使用它们检索所添加项的相应列表条目。 在本示例中，我们分别将令牌存储在 和 faToken 中mruToken，但不对它们执行任何其他操作。

此外，示例中的 savePicker 变量包含由示例创建的 FileSavePicker 对象。 若要详细了解如何使用文件选取器保存文件，请参阅 使用选取器保存文件。 若要了解如何访问文件，请参阅 使用选取器打开文件和文件夹。

注解

使用最近使用的 (MRU) 列表跟踪用户经常访问的文件和/或位置。

此列表最多可以存储 25 个项目。 虽然应用必须向 MRU 添加项才能跟踪它们，但 Windows 会在必要时删除过时的项目来保留 25 项的限制。

注意

如果要响应 ItemRemoved 事件，则必须在每次获取对 StorageItemMostRecentlyUsedList 的新引用时注册事件处理程序。

若要查看更多代码示例，请参阅 文件选取器示例 和 文件访问示例。

若要了解如何使用 FutureAccessList 和 MostRecentlyUsedList，请参阅 跟踪最近使用的文件和文件夹。

若要详细了解应用有权访问的文件和位置，请参阅 文件访问权限。

属性

Entries	获取用于从最近使用的 (MRU) 列表中检索存储项的对象。
MaximumItemsAllowed	获取最近使用的 (MRU) 列表可以包含的最大存储项数。

方法

Add(IStorageItem)	将新存储项添加到最近使用的 (MRU) 列表中。
Add(IStorageItem, String)	将新的存储项和随附的元数据添加到最近使用的 (MRU) 列表中。
Add(IStorageItem, String, RecentStorageItemVisibility)	将新的存储项和随附的元数据添加到最近使用的 (MRU) 列表中，指定其在列表中的可见性范围。
AddOrReplace(String, IStorageItem)	将新存储项添加到最近使用的 (MRU) 列表中，或者替换指定的项（如果列表中已存在）。
AddOrReplace(String, IStorageItem, String)	将新的存储项和随附的元数据添加到最近使用的 (MRU) 列表中，或者替换指定的项（如果列表中已存在）。
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	将新的存储项和随附的元数据添加到最近使用的 (MRU) 列表中，或者替换指定的项（如果列表中已存在）。 还指定其在列表中的可见性范围。
CheckAccess(IStorageItem)	确定应用是否有权访问最近使用的 (MRU) 列表中的指定存储项。
Clear()	从最近使用的 (MRU) 列表中删除所有存储项。
ContainsItem(String)	确定最近使用的 (MRU) 列表是否包含指定的存储项。
GetFileAsync(String)	从最近使用的 (MRU) 列表中检索指定的 storageFile 。
GetFileAsync(String, AccessCacheOptions)	使用指定的选项从最近使用的 (MRU) 列表中检索指定的 storageFile 。
GetFolderAsync(String)	从最近使用的 (MRU) 列表中检索指定的 StorageFolder 。
GetFolderAsync(String, AccessCacheOptions)	使用指定的选项从最近使用的 (MRU) 列表中检索指定的 StorageFolder 。
GetItemAsync(String)	从最近使用的 (MRU) 列表中检索指定项 (如文件或文件夹) 。
GetItemAsync(String, AccessCacheOptions)	使用指定选项从最近使用的 (MRU) 列表中检索指定项 (，例如文件或文件夹) 。
Remove(String)	从最近使用的 (MRU) 列表中删除指定的存储项。

事件

ItemRemoved

从最近使用的 (MRU) 列表中删除存储项时触发。

另请参阅

• MostRecentlyUsedList