Поделиться через


StorageItemMostRecentlyUsedList Класс

Определение

Представляет последний используемый список (MRU) вашего приложения (полученный из статического свойства StorageApplicationPermissions.MostRecentlyUsedList ). Вы используете MRU для отслеживания элементов (файлов и (или) папок), к которым пользователь недавно получил доступ. Элементы хранятся в MRU в виде объектов StorageFile и StorageFolder .

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
Атрибуты
Реализации

Требования к 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 , созданный примером. Дополнительные сведения о сохранении файлов с помощью средства выбора файлов см. в разделе Сохранение файла с помощью средства выбора. Дополнительные сведения о доступе к файлам см. в статье Открытие файлов и папок с помощью средства выбора.

Комментарии

Используйте список последних использованных (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)

Извлекает указанный storageFile из списка последних использованных (MRU).

GetFileAsync(String, AccessCacheOptions)

Извлекает указанный storageFile из списка последних использованных (MRU) с помощью указанных параметров.

GetFolderAsync(String)

Извлекает указанный объект StorageFolder из списка последних использованных (MRU).

GetFolderAsync(String, AccessCacheOptions)

Извлекает указанный объект StorageFolder из списка последних использованных (MRU) с помощью указанных параметров.

GetItemAsync(String)

Извлекает указанный элемент (например, файл или папку) из списка последних использованных элементов (MRU).

GetItemAsync(String, AccessCacheOptions)

Извлекает указанный элемент (например, файл или папку) из списка последних использованных (MRU) с помощью указанных параметров.

Remove(String)

Удаляет указанный элемент хранилища из списка последних использованных (MRU).

События

ItemRemoved

Срабатывает при удалении элемента хранилища из списка последних использованных элементов (MRU).

Применяется к

См. также раздел