Compartilhar via


StorageItemMostRecentlyUsedList Classe

Definição

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
Implementações

Requisitos do Windows

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

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

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

ItemRemoved

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

Aplica-se a

Confira também