StorageItemMostRecentlyUsedList Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.AccessCache

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta l'elenco usato più di recente dell'app (MRU) ottenuto dalla proprietà static StorageApplicationPermissions.MostRecentlyUsedList . L'utente usa mru per tenere traccia degli elementi (file e/o cartelle) a cui l'utente ha eseguito l'accesso più di recente. Gli elementi vengono archiviati nell'unità mru come oggetti StorageFile e StorageFolder .

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

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

Nota

Se si vuole rispondere agli eventi ItemRemoved , è necessario registrare il gestore eventi ogni volta che si ottiene un nuovo riferimento a StorageItemMostRecentlyUsedList.

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 degli elementi usati più di recente.
MaximumItemsAllowed	Ottiene il numero massimo di elementi di archiviazione che l'elenco degli elementi usati più di recente può contenere.

Metodi

Add(IStorageItem)	Aggiunge un nuovo elemento di archiviazione all'elenco di elementi usati più di recente.
Add(IStorageItem, String)	Aggiunge un nuovo elemento di archiviazione e i metadati associati all'elenco degli ultimi elementi usati.
Add(IStorageItem, String, RecentStorageItemVisibility)	Aggiunge un nuovo elemento di archiviazione e i metadati associati all'elenco di elementi usati più di recente, specificando l'estensione della visibilità nell'elenco.
AddOrReplace(String, IStorageItem)	Aggiunge un nuovo elemento di archiviazione all'elenco usato più di recente oppure sostituisce l'elemento specificato, se già esistente nell'elenco.
AddOrReplace(String, IStorageItem, String)	Aggiunge un nuovo elemento di archiviazione e i metadati associati all'elenco usato più di recente oppure sostituisce l'elemento specificato, se già esistente nell'elenco.
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	Aggiunge un nuovo elemento di archiviazione e i metadati associati all'elenco usato più di recente oppure sostituisce l'elemento specificato, se già esistente nell'elenco. Specifica anche l'estensione della visibilità nell'elenco.
CheckAccess(IStorageItem)	Determina se l'app ha accesso all'elemento di archiviazione specificato nell'elenco degli ultimi elementi usati.
Clear()	Rimuove tutti gli elementi di archiviazione dall'elenco degli elementi di archiviazione usati più di recente.
ContainsItem(String)	Determina se l'elenco utilizzato più di recente contiene l'elemento di archiviazione specificato.
GetFileAsync(String)	Recupera l'oggetto storageFile specificato dall'elenco degli ultimi file usati.
GetFileAsync(String, AccessCacheOptions)	Recupera l'oggetto storageFile specificato dall'elenco degli ultimi elementi usati (MRU) usando le opzioni specificate.
GetFolderAsync(String)	Recupera l'oggetto StorageFolder specificato dall'elenco degli ultimi elementi usati.
GetFolderAsync(String, AccessCacheOptions)	Recupera l'oggetto StorageFolder specificato dall'elenco degli ultimi elementi usati 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 degli ultimi elementi usati utilizzando le opzioni specificate.
Remove(String)	Rimuove l'elemento di archiviazione specificato dall'elenco di elementi di archiviazione usati più di recente.

Eventi

ItemRemoved

Viene generato quando un elemento di archiviazione viene rimosso dall'elenco degli elementi usati più di recente.

Si applica a

Vedi anche

MostRecentlyUsedList