StorageItemAccessList Classe

Definizione

Spazio dei nomi:

Windows.Storage.AccessCache

Rappresenta l'elenco di accesso futuro dell'app (ottenuto dalla proprietà static StorageApplicationPermissions.FutureAccessList ). Con la selezione di file e cartelle concedi alla tua app le autorizzazioni per accedere a elementi che potrebbero non essere accessibili altrimenti. Aggiungendo questi elementi all'elenco degli accessi futuri mantieni queste autorizzazioni quando l'app vorrà accedere di nuovo a tali elementi in un secondo momento. Gli elementi vengono archiviati nell'elenco di accesso futuro come oggetti 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

Ereditarietà

Object Platform::Object IInspectable StorageItemAccessList

Attributi

ContractVersionAttribute

Implementazioni

IStorageItemAccessList

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Questo esempio illustra come aggiungere un elemento a FutureAccessList e MostRecentlyUsedList dell'app.

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

È consigliabile archiviare i token restituiti da StorageApplicationPermissions.MostRecentlyUsedList.Add e StorageApplicationPermissions.FutureAccessList.Add in modo da poterli usare per recuperare la rispettiva voce di elenco per l'elemento aggiunto. Nell'esempio i token vengono archiviati rispettivamente in mruToken e faToken ma non vengono eseguite altre operazioni.

Inoltre, la savePicker variabile nell'esempio contiene un oggetto FileSavePicker creato dall'esempio. Per altre informazioni sull'uso della selezione file, vedere Aprire file e cartelle con una selezione e Salvare un file con una selezione.

Commenti

Usa questo elenco di accesso futuro per mantenere l'accesso a file e percorsi che potrebbero non essere inclusi nei percorsi accessibili specificati dalle funzionalità nel manifesto dell'app. Ad esempio, se l'app usa una selezione file per accedere a un file (o a un percorso), è consigliabile archiviare storageFile restituito dalla selezione file in questo elenco di accesso futuro.

Questo elenco può archiviare fino a 1000 elementi e deve essere gestito dall'app.

Per altri esempi di codice, vedere l'esempio di selezione file e l'esempio di accesso ai file.

Per informazioni sull'uso di FutureAccessList e MostRecentlyUsedList, vedere Tenere traccia dei file e delle cartelle usati di recente.

Per altre informazioni sui file e i percorsi a cui l'app ha l'autorizzazione per accedere, vedere Autorizzazioni di accesso ai file.

Proprietà

Entries	Ottiene un oggetto per il recupero di elementi di archiviazione dall'elenco di accesso.
MaximumItemsAllowed	Ottiene il numero massimo di elementi di archiviazione che l'elenco di accesso può contenere.

Metodi

Add(IStorageItem)	Aggiunge un nuovo elemento di archiviazione all'elenco di accesso.
Add(IStorageItem, String)	Aggiunge un nuovo elemento di archiviazione e i metadati associati all'elenco di accesso.
AddOrReplace(String, IStorageItem)	Aggiunge un nuovo elemento di archiviazione all'elenco di accesso o sostituisce l'elemento specificato se esiste già nell'elenco.
AddOrReplace(String, IStorageItem, String)	Aggiunge un nuovo elemento di archiviazione e i metadati associati all'elenco di accesso oppure sostituisce l'elemento specificato, se già esistente nell'elenco.
CheckAccess(IStorageItem)	Determina se l'app ha accesso all'elemento di archiviazione specificato nell'elenco di accesso.
Clear()	Rimuove tutti gli elementi di archiviazione dall'elenco di accesso.
ContainsItem(String)	Determina se l'elenco di accesso contiene l'elemento di archiviazione specificato.
GetFileAsync(String)	Recupera l'oggetto StorageFile specificato dall'elenco.
GetFileAsync(String, AccessCacheOptions)	Recupera StorageFile dall'elenco utilizzando le opzioni specificate.
GetFolderAsync(String)	Recupera l'oggetto StorageFolder specificato dall'elenco.
GetFolderAsync(String, AccessCacheOptions)	Recupera l'oggetto StorageFolder specificato dall'elenco utilizzando le opzioni specificate.
GetItemAsync(String)	Recupera l'elemento specificato, ad esempio un file o una cartella, dall'elenco degli ultimi elementi usati.
GetItemAsync(String, AccessCacheOptions)	Recupera l'elemento specificato , ad esempio un file o una cartella, dall'elenco utilizzando le opzioni specificate.
Remove(String)	Rimuove l'elemento di archiviazione specificato dall'elenco di accesso.

Vedi anche

• FutureAccessList