StorageApplicationPermissions 类

定义

命名空间:

Windows.Storage.AccessCache

提供静态属性，以便获取应用的最近使用列表 (MRU) (StorageApplicationPermissions.MostRecentlyUsedList) 和未来访问列表 (使用 StorageApplicationPermissions.FutureAccessList。

public ref class StorageApplicationPermissions abstract sealed

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

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class StorageApplicationPermissions

Public Class StorageApplicationPermissions

继承

Object Platform::Object IInspectable StorageApplicationPermissions

属性

ContractVersionAttribute

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 对象。 若要详细了解如何使用文件选取器保存文件，请参阅 使用选取器保存文件。 若要了解如何访问文件，请参阅 使用选取器打开文件和文件夹。

注解

静态访问此类的方法和属性。

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

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

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

版本历史记录

Windows 版本	SDK 版本	增值
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

属性

FutureAccessList	获取一个 对象，该对象表示应用维护的列表，以便应用可以存储文件和/或位置 (，如文件夹) ，并在将来轻松访问这些项目。
MostRecentlyUsedList	获取一个 对象，该对象表示一个列表，应用可以使用该列表跟踪文件和/或位置 (，例如应用最近访问的文件夹) 。

方法

GetFutureAccessListForUser(User)	获取一个 对象，该对象表示应用维护的列表，以便应用可以存储文件和/或位置 (，如文件夹) ，并在将来轻松访问这些项目。 此方法返回一个对象，该对象的范围限定为指定用户。 将此方法用于 多用户应用程序。
GetMostRecentlyUsedListForUser(User)	获取一个 对象，应用可以使用该对象跟踪应用最近访问的文件和/或位置 (如文件夹) 。 此方法返回一个对象，该对象的范围限定为指定用户。 将此方法用于 多用户应用程序。