StorageItemMostRecentlyUsedList Classe

Definizione

public ref class StorageItemMostRecentlyUsedList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemMostRecentlyUsedList final

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

Public NotInheritable Class StorageItemMostRecentlyUsedList

Ereditarietà

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

Attributi

ContractVersionAttribute

Implementazioni

IStorageItemAccessList

Requisiti Windows

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

Usare l'elenco degli ultimi utenti usati per tenere traccia dei file e/o dei percorsi a cui l'utente accede di frequente.

Questo elenco può archiviare fino a 25 elementi. Anche se l'app deve aggiungere elementi all'mrU per tenerne traccia, Windows mantiene il limite di 25 elementi rimuovendo gli elementi non aggiornati, se necessario.

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à

Metodi

Eventi

Si applica a

Vedi anche

• MostRecentlyUsedList