StorageItemAccessList Classe

Definição

Namespace:

Windows.Storage.AccessCache

Representa a lista de acesso futuro do aplicativo (obtida da propriedade StorageApplicationPermissions.FutureAccessList estática). Selecionando arquivos e pastas, o usuário concede a seu aplicativo permissão para acessar itens que podem não estar acessíveis de outra maneira. Se você adicionar esses itens à sua lista de acesso futuro, manterá essa permissão quando seu aplicativo quiser acessar esses itens novamente mais tarde. Os itens são armazenados na lista de acesso futuro como objetos StorageFile e StorageFolder .

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

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

Entries	Obtém um objeto para recuperar itens de armazenamento da lista de acesso.
MaximumItemsAllowed	Obtém o número máximo de itens de armazenamento que a lista de acesso pode conter.

Métodos

Add(IStorageItem)	Adiciona um novo item de armazenamento à lista de acesso.
Add(IStorageItem, String)	Adiciona um novo item de armazenamento e metadados de acompanhamento à lista de acesso.
AddOrReplace(String, IStorageItem)	Adiciona um novo item de armazenamento à lista de acesso ou substitui o item especificado se ele já existir na lista.
AddOrReplace(String, IStorageItem, String)	Adiciona um novo item de armazenamento e metadados de acompanhamento à lista de acesso ou substitui o item especificado se ele já existir na lista.
CheckAccess(IStorageItem)	Determina se o aplicativo tem acesso ao item de armazenamento especificado na lista de acesso.
Clear()	Remove todos os itens de armazenamento da lista de acesso.
ContainsItem(String)	Determina se a lista de acesso contém o item de armazenamento especificado.
GetFileAsync(String)	Recupera o StorageFile especificado da lista.
GetFileAsync(String, AccessCacheOptions)	Recupera o StorageFile da lista usando as opções especificadas.
GetFolderAsync(String)	Recupera o StorageFolder especificado da lista.
GetFolderAsync(String, AccessCacheOptions)	Recupera o StorageFolder especificado da lista 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 usando as opções especificadas.
Remove(String)	Remove o item de armazenamento especificado da lista de acesso.

Confira também

• FutureAccessList