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 , чтобы использовать их для получения соответствующей записи списка для добавленного элемента. В этом примере мы храним маркеры в mruToken и faToken соответственно, но больше с ними не делаем никаких действий.

Кроме того, savePicker переменная в примере содержит объект FileSavePicker , созданный примером. Дополнительные сведения о сохранении файлов с помощью средства выбора файлов см. в разделе Сохранение файла с помощью средства выбора. Дополнительные сведения о доступе к файлам см. в статье Открытие файлов и папок с помощью средства выбора.

Комментарии

Статический доступ к методам и свойствам этого класса.

Дополнительные примеры кода см. в примерах средства выбора файлов и в примере доступа к файлам.

Дополнительные сведения об использовании FutureAccessList и MostRecentlyUsedList см. в статье Отслеживание недавно использовавшихся файлов и папок.

Сведения о том, к каким файлам и расположениям у приложения есть разрешения на доступ, см. в разделе Разрешения на доступ к файлам.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Свойства

FutureAccessList	Возвращает объект , представляющий список, который поддерживает приложение, чтобы приложение хранящее файлы и (или) расположения (например, папки) и легко получать доступ к этим элементам в будущем.
MostRecentlyUsedList	Возвращает объект , представляющий список, который приложение может использовать для отслеживания файлов и (или) расположений (например, папок), к которым приложение недавно получало доступ.

Методы

GetFutureAccessListForUser(User)	Возвращает объект , представляющий список, который поддерживает приложение, чтобы приложение хранящее файлы и (или) расположения (например, папки) и легко получать доступ к этим элементам в будущем. Этот метод возвращает объект, ограниченный заданным пользователем. Используйте этот метод для многопользовательских приложений.
GetMostRecentlyUsedListForUser(User)	Возвращает объект, который приложение может использовать для отслеживания файлов и (или) расположений (например, папок), к которым приложение недавно получало доступ. Этот метод возвращает объект, ограниченный заданным пользователем. Используйте этот метод для многопользовательских приложений.