Tenere traccia di cartelle e file usati di recente

API Importanti

• MostRecentlyUsedList
• FileOpenPicker

Tieni traccia dei file a cui l'utente accede frequentemente aggiungendoli all'elenco MRU dell'app. La piattaforma gestisce per te la lista MRU (Most Recently Used) ordinando automaticamente gli elementi in base al momento dell'ultimo accesso e rimuovendo l'elemento più vecchio quando viene raggiunto il limite massimo di 25 elementi. Tutte le app hanno il proprio MRU.

L'MRU dell'app è rappresentato dalla classe StorageItemMostRecentlyUsedList , ottenuta dalla proprietà static StorageApplicationPermissions.MostRecentlyUsedList . Gli elementi MRU vengono archiviati come oggetti IStorageItem , quindi sia gli oggetti StorageFile (che rappresentano i file) che gli oggetti StorageFolder (che rappresentano le cartelle) possono essere aggiunti all'elenco mru.

Prerequisiti

• Informazioni sulla programmazione asincrona per le app WinUI

  Per informazioni su come scrivere app asincrone in C#, vedere Chiamare API asincrone in C# o Visual Basic. Per informazioni su come scrivere app asincrone in C++, vedere Programmazione asincrona in C++.

• Autorizzazioni di accesso alla posizione

  Vedere Autorizzazioni di accesso ai file.

• Aprire file e cartelle con una selezione

  I file scelti sono spesso gli stessi file a cui gli utenti tornano di nuovo e di nuovo.

Aggiungere un file selezionato nella lista MRU

• I file scelti dall'utente sono spesso file restituiti ripetutamente. Considera quindi l'aggiunta di file selezionati al MRU dell'applicazione una volta selezionati. Ecco come.

  Windows.Storage.StorageFile file = await picker.PickSingleFileAsync();
  
  var mru = Windows.Storage.AccessCache.StorageApplicationPermissions.MostRecentlyUsedList;
  string mruToken = mru.Add(file, "profile pic");
  

  StorageItemMostRecentlyUsedList.Add è sovraccaricato. Nell'esempio viene usato Add(IStorageItem, String) in modo da poter associare i metadati al file. L'impostazione dei metadati consente di registrare lo scopo dell'elemento, ad esempio "profilo pic". È anche possibile aggiungere il file a MRU senza metadati chiamando Add(IStorageItem). Quando si aggiunge un elemento all'elenco mru, il metodo restituisce una stringa di identificazione univoca, denominata token, che viene usata per recuperare l'elemento.

Usare un token per recuperare un elemento dalla lista MRU

Usare il metodo di recupero più appropriato per l'elemento da recuperare.

• Recuperare un file come StorageFile usando GetFileAsync.
• Recuperare una cartella come StorageFolder usando GetFolderAsync.
• Recuperare un oggetto IStorageItem generico, che può rappresentare un file o una cartella, usando GetItemAsync.

Ecco come recuperare il file appena aggiunto.

StorageFile retrievedFile = await mru.GetFileAsync(mruToken);

Ecco come eseguire l'iterazione di tutte le voci per ottenere i token e quindi gli elementi.

foreach (Windows.Storage.AccessCache.AccessListEntry entry in mru.Entries)
{
    string mruToken = entry.Token;
    string mruMetadata = entry.Metadata;
    Windows.Storage.IStorageItem item = await mru.GetItemAsync(mruToken);
    // The type of item will tell you whether it's a file or a folder.
}

AccessListEntryView consente di iterare le voci nell'elenco dei più recenti utilizzati (MRU). Queste voci sono strutture AccessListEntry che contengono il token e i metadati per un elemento.

Rimozione di elementi dall'elenco MRU quando è pieno

Quando viene raggiunto il limite di 25 elementi di MRU e si tenta di aggiungere un nuovo elemento, l'elemento a cui si accede più tempo fa viene rimosso automaticamente. Quindi, non è mai necessario rimuovere un elemento prima di aggiungerne uno nuovo.

Elenco di accesso futuro

Oltre a un elenco MRU, l'app ha anche una lista di accesso futuro. Selezionando file e cartelle, l'utente concede all'app l'autorizzazione per accedere agli elementi che potrebbero non essere accessibili altrimenti. Se si aggiungono questi elementi all'elenco di accesso futuro, si manterrà tale autorizzazione quando l'app vuole accedere nuovamente a tali elementi in un secondo momento. L'elenco di accesso futuro dell'app è rappresentato dalla classe StorageItemAccessList , ottenuta dalla proprietà static StorageApplicationPermissions.FutureAccessList .

Quando un utente seleziona un oggetto, è consigliabile aggiungerlo all'elenco per accesso futuro e all'elenco MRU (elementi utilizzati di recente).

• FutureAccessList può contenere fino a 1000 elementi. Ricorda: può contenere cartelle e file, quindi è un sacco di cartelle.
• La piattaforma non rimuove mai gli elementi da FutureAccessList automaticamente. Quando si raggiunge il limite di 1000 elementi, non è possibile aggiungere un altro fino a quando non si crea spazio con il metodo Remove .