Condividi tramite


StorageApplicationPermissions Classe

Definizione

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

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.

Si applica a