StorageApplicationPermissions Classe

Definição

Namespace:

Windows.Storage.AccessCache

Fornece propriedades estáticas para você obter a LISTA usada mais recentemente (MRU) do aplicativo (use StorageApplicationPermissions.MostRecentlyUsedList) e lista de acesso futuro (use 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

Herança

Object Platform::Object IInspectable StorageApplicationPermissions

Atributos

ContractVersionAttribute

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

É recomendável armazenar 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

Acesse os métodos e as propriedades dessa classe estaticamente.

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 o 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.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Propriedades

FutureAccessList	Obtém um objeto que representa uma lista que um aplicativo mantém para que o aplicativo possa armazenar arquivos e/ou locais (como pastas) e acessar facilmente esses itens no futuro.
MostRecentlyUsedList	Obtém um objeto que representa uma lista que um aplicativo pode usar para rastrear os arquivos e/ou locais (como pastas) que o aplicativo acessou mais recentemente.

Métodos

GetFutureAccessListForUser(User)	Obtém um objeto que representa uma lista que um aplicativo mantém para que o aplicativo possa armazenar arquivos e/ou locais (como pastas) e acessar facilmente esses itens no futuro. Esse método retorna um objeto com escopo para o usuário especificado. Use esse método para aplicativos multiusuários.
GetMostRecentlyUsedListForUser(User)	Obtém um objeto que um aplicativo pode usar para rastrear os arquivos e/ou locais (como pastas) que o aplicativo acessou mais recentemente. Esse método retorna um objeto com escopo para o usuário especificado. Use esse método para aplicativos multiusuários.