StorageItemMostRecentlyUsedList Classe

Definição

Namespace:

Windows.Storage.AccessCache

Representa a MRU (lista usada mais recentemente) do aplicativo (obtida da propriedade StorageApplicationPermissions.MostRecentlyUsedList estática). Você usa a MRU para acompanhar itens (arquivos e/ou pastas) que o usuário acessou mais recentemente. Os itens são armazenados na MRU como objetos StorageFile e 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

Herança

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

Atributos

ContractVersionAttribute

Implementações

IStorageItemAccessList

Requisitos do Windows

Requisitos	Description
Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo demonstra como adicionar um item a FutureAccessList e MostRecentlyUsedList do aplicativo.

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
    }
}

Recomendamos que você armazene os tokens retornados por StorageApplicationPermissions.MostRecentlyUsedList.Add e StorageApplicationPermissions.FutureAccessList.Add para que você possa usá-los para recuperar a respectiva entrada de lista para o item que você adicionou. No exemplo, armazenamos os tokens em mruToken e faToken , respectivamente, mas não fazemos mais nada com eles.

Além disso, a savePicker variável no exemplo contém um objeto FileSavePicker que foi criado pelo exemplo. Para saber mais sobre como salvar arquivos com o seletor de arquivos, consulte Salvar um arquivo com um seletor. Para saber mais sobre como acessar arquivos, consulte Abrir arquivos e pastas com um seletor.

Comentários

Use a lista mru (usada mais recentemente) para rastrear arquivos e/ou locais que seu usuário acessa com frequência.

Essa lista pode armazenar até 25 itens. Embora o aplicativo precise adicionar itens à MRU para rastreá-los, o Windows mantém o limite de 25 itens removendo itens obsoletos, se necessário.

Observação

Se você quiser responder a eventos ItemRemoved, registre seu manipulador de eventos sempre que receber uma nova referência para StorageItemMostRecentlyUsedList.

Para ver mais exemplos de código, consulte o Exemplo do seletor de arquivos e o Exemplo de acesso ao arquivo.

Para saber mais sobre como usar o FutureAccessList e MostRecentlyUsedList, consulte Rastrear arquivos e pastas usados recentemente.

Para saber mais sobre quais arquivos e locais seu aplicativo tem permissão para acessar, consulte Permissões de acesso a arquivos.

Propriedades

Nome	Description
Entries	Obtém um objeto para recuperar itens de armazenamento da lista MRU (usada mais recentemente).
MaximumItemsAllowed	Obtém o número máximo de itens de armazenamento que a lista MRU (usada mais recentemente) pode conter.

Métodos

Nome	Description
Add(IStorageItem)	Adiciona um novo item de armazenamento à lista mru (usada mais recentemente).
Add(IStorageItem, String)	Adiciona um novo item de armazenamento e metadados que acompanham à lista mru (usada mais recentemente).
Add(IStorageItem, String, RecentStorageItemVisibility)	Adiciona um novo item de armazenamento e metadados de acompanhamento à lista mru (usada mais recentemente), especificando a extensão de sua visibilidade na lista.
AddOrReplace(String, IStorageItem)	Adiciona um novo item de armazenamento à lista mru (usada mais recentemente) ou substitui o item especificado se ele já existir na lista.
AddOrReplace(String, IStorageItem, String)	Adiciona um novo item de armazenamento e metadados que acompanham à lista mru (usada mais recentemente) ou substitui o item especificado se ele já existir na lista.
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	Adiciona um novo item de armazenamento e metadados que acompanham à lista mru (usada mais recentemente) ou substitui o item especificado se ele já existir na lista. Também especifica a extensão de sua visibilidade na lista.
CheckAccess(IStorageItem)	Determina se o aplicativo tem acesso ao item de armazenamento especificado na lista mru (usada mais recentemente).
Clear()	Remove todos os itens de armazenamento da lista mru (usada mais recentemente).
ContainsItem(String)	Determina se a lista mru (usada mais recentemente) contém o item de armazenamento especificado.
GetFileAsync(String)	Recupera o storageFile especificado da lista mru (usada mais recentemente).
GetFileAsync(String, AccessCacheOptions)	Recupera o storageFile especificado da lista mru (usada mais recentemente) usando as opções especificadas.
GetFolderAsync(String)	Recupera o StorageFolder especificado da lista mru (usada mais recentemente).
GetFolderAsync(String, AccessCacheOptions)	Recupera o StorageFolder especificado da lista mru (usada mais recentemente) usando as opções especificadas.
GetItemAsync(String)	Recupera o item especificado (como um arquivo ou pasta) da lista MRU (usada mais recentemente).
GetItemAsync(String, AccessCacheOptions)	Recupera o item especificado (como um arquivo ou pasta) da lista MRU (usada mais recentemente) usando as opções especificadas.
Remove(String)	Remove o item de armazenamento especificado da lista mru (usada mais recentemente).

Eventos

Nome	Description
ItemRemoved	É acionado quando um item de armazenamento é removido da lista mru (usada mais recentemente).

Confira também

• MostRecentlyUsedList