StorageApplicationPermissions Classe

Definizione

Spazio dei nomi:

Windows.Storage.AccessCache

Fornisce proprietà statiche per ottenere l'elenco degli ultimi utilizzi dell'app (MRU) (usare StorageApplicationPermissions.MostRecentlyUsedList) e l'elenco di accesso futuro (usare 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

Ereditarietà

Object Platform::Object IInspectable StorageApplicationPermissions

Attributi

ContractVersionAttribute

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 che sia possibile usarli 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 sul salvataggio dei file con selezione file, vedere Salvare un file con una selezione. Per informazioni sull'accesso ai file, vedere Aprire file e cartelle con una selezione.

Commenti

Accedere ai metodi e alle proprietà di questa classe in modo statico.

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 informazioni sui file e i percorsi a cui l'app ha l'autorizzazione per accedere, vedere Autorizzazioni di accesso ai file.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Proprietà

FutureAccessList	Ottiene un oggetto che rappresenta un elenco gestito da un'app in modo che l'app possa archiviare file e/o percorsi (ad esempio cartelle) e accedere facilmente a questi elementi in futuro.
MostRecentlyUsedList	Ottiene un oggetto che rappresenta un elenco che un'app può usare per tenere traccia dei file e/o dei percorsi (ad esempio cartelle) a cui l'app ha eseguito l'accesso più di recente.

Metodi

GetFutureAccessListForUser(User)	Ottiene un oggetto che rappresenta un elenco gestito da un'app in modo che l'app possa archiviare file e/o percorsi (ad esempio cartelle) e accedere facilmente a questi elementi in futuro. Questo metodo restituisce un oggetto con ambito per l'utente specificato. Usare questo metodo per le applicazioni multiutente.
GetMostRecentlyUsedListForUser(User)	Ottiene un oggetto che un'app può usare per tenere traccia dei file e/o dei percorsi (ad esempio cartelle) a cui l'app ha eseguito l'accesso più di recente. Questo metodo restituisce un oggetto con ambito per l'utente specificato. Usare questo metodo per le applicazioni multiutente.