StorageItemAccessList Classe

Definição

public ref class StorageItemAccessList sealed : IStorageItemAccessList

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemAccessList final : IStorageItemAccessList

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemAccessList : IStorageItemAccessList

Public NotInheritable Class StorageItemAccessList
Implements IStorageItemAccessList

Herança

Object Platform::Object IInspectable StorageItemAccessList

Atributos

ContractVersionAttribute

Implementações

IStorageItemAccessList

Requisitos do Windows

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 usar o seletor de arquivos, consulte Abrir arquivos e pastas com um seletor e Salvar um arquivo com um seletor.

Comentários

Use essa lista de acesso futuro para preservar o acesso a arquivos e locais que podem não ser incluídos nos locais acessíveis especificados pelos recursos no manifesto do aplicativo. Por exemplo, se seu aplicativo usa um seletor de arquivos para acessar um arquivo (ou local), recomendamos que você armazene o StorageFile retornado do seletor de arquivos nesta lista de acesso futuro.

Essa lista pode armazenar até 1000 itens e deve ser mantida pelo aplicativo.

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

Métodos

Aplica-se a

Confira também

• FutureAccessList