Nachverfolgen kürzlich verwendeter Dateien und Ordner

Artikel
07/13/2023

Wichtige APIs

Sie können Dateien nachverfolgen, auf die häufig zugegriffen wird, indem Sie sie der Liste mit den zuletzt verwendeten Elementen (MRU) der App hinzufügen. Die Plattform verwaltet die MRU für Sie. Dabei werden Elemente nach der Zeit und dem Ort des letzten Zugriffs sortiert und die ältesten Elemente entfernt, wenn das Limit von 25 Elementen erreicht ist. Alle Apps besitzen eine eigene MRU.

Ihre App-MRU-Liste wird durch die StorageItemMostRecentlyUsedList-Klasse repräsentiert, die Sie aus der statischen StorageApplicationPermissions.MostRecentlyUsedList-Eigenschaft abrufen können. MRU-Elemente werden als IStorageItem-Objekte gespeichert. Das bedeutet, dass sowohl StorageFile-Objekte (die Dateien darstellen) als auch StorageFolder-Objekte (die Ordner darstellen) der MRU-Liste hinzugefügt werden können.

Hinweis

Vollständige Beispiele finden Sie im Beispiel zur Dateiauswahl und im Beispiel zum Dateizugriff.

Voraussetzungen

Kenntnisse in der asynchronen Programmierung für Apps für die universelle Windows-Plattform (UWP)

Informationen zum Schreiben von asynchronen Apps in C# oder Visual Basic finden Sie unter Aufrufen asynchroner APIs in C# oder Visual Basic. Informationen zum Schreiben von asynchronen Apps in C++ finden Sie unter Asynchrone Programmierung in C++.
Zugriffsberechtigungen für den Speicherort

Weitere Informationen finden Sie unter Berechtigungen für den Dateizugriff.
Öffnen von Dateien und Ordnern mit einer Auswahl

Die ausgewählten Dateien sind meist diejenigen, auf die Benutzer immer wieder zugreifen.

Hinzufügen der ausgewählten Dateien zu MRU

Die Dateien, die der Benutzer wählt sind häufig Dateien, denen sie wiederholt zurückgeben werden. Erwägen Sie also, die ausgewählten Dateien Ihrer App-MRU-Liste hinzufügen, sobald sie ausgewählt werden. Gehen Sie dazu wie folgt vor:
```
Windows.Storage.StorageFile file = await picker.PickSingleFileAsync();

var mru = Windows.Storage.AccessCache.StorageApplicationPermissions.MostRecentlyUsedList;
string mruToken = mru.Add(file, "profile pic");
```
StorageItemMostRecentlyUsedList.Add ist überladen. Im Beispiel verwenden wir Add(IStorageItem, String), sodass wir der Datei Metadaten zuordnen können. Wenn Sie Metadaten festlegen, können Sie den Zweck des Elements festlegen, z. B. Profilauswahl. Sie können die Datei durch einen Aufruf von Add(IStorageItem) auch ohne Metadaten der MRU-Liste hinzufügen. Beim Hinzufügen eines Elements zur MRU-Liste gibt die Methode eine eindeutig identifizierende Zeichenfolge zurück. Mit diesem sogenannten Token wird das Element abgerufen.

Tipp

Sie benötigen das Token zum Abrufen eines Elements aus der MRU-Liste. Speichern Sie es daher an einem beliebigen Ort. Weitere Informationen zu App-Daten finden Sie unter Verwalten von Anwendungsdaten.

Verwenden von Token zum Abrufen von Elementen aus der MRU-Liste

Verwenden Sie die Abrufmethode, die für das abzurufende Element am besten geeignet ist.

Rufen Sie mit GetFileAsync eine Datei als StorageFile ab.
Rufen Sie mit GetFolderAsync einen Ordner als StorageFolder ab.
Rufen Sie mit GetItemAsync ein allgemeines IStorageItem-Element ab, das eine Datei oder einen Ordner darstellen kann.

Im Folgenden erfahren Sie, wie Sie die Datei abrufen können, die gerade hinzugefügt wurde.

StorageFile retrievedFile = await mru.GetFileAsync(mruToken);

Hier wird erläutert, wie alle Einträge zum Abrufen von Token und anschließend Elementen durchlaufen werden.

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

Mit AccessListEntryView können Sie Einträge in der MRU-Liste durchlaufen. Diese Einträge sind AccessListEntry-Strukturen, die das Token und Metadaten für ein Element enthalten.

Entfernen von Elementen aus der MRU-Liste beim Erreichen des Grenzwerts

Wenn das Limit von 25 Elementen der MRU-Liste erreicht ist und ein neues Element hinzugefügt werden soll, wird das älteste Element (bei dem der letzte Zugriff am längsten zurück liegt) automatisch entfernt. Sie müssen also nie ein Element entfernen, bevor Sie ein neues hinzufügen.

Liste für zukünftigen Zugriff

Genau wie eine MRU-Liste besitzt auch Ihre App eine Liste für zukünftigen Zugriff. Durch die Auswahl von Dateien und Ordnern erteilt der Benutzer Ihrer App die Berechtigung zum Zugreifen auf Elemente, auf die andernfalls nicht zugegriffen werden kann. Wenn Sie diese Elemente zu Ihrer Liste für zukünftigen Zugriff hinzufügen, behalten Sie die Berechtigung, wenn Ihre App später erneut auf diese Elemente zugreifen möchte. Ihre App-Liste für zukünftigen Zugriff wird durch die StorageItemAccessList-Klasse dargestellt, die Sie aus der statischen StorageApplicationPermissions.FutureAccessList-Eigenschaft abrufen.

Wenn ein Benutzer ein Element auswählt, sollten Sie es Ihrer Liste für zukünftigen Zugriff und der MRU-Liste hinzufügen.

FutureAccessList kann bis zu 1.000 Elemente enthalten. Denken Sie daran: Die Liste kann Ordner und Dateien enthalten. Das können also eine ganze Menge Ordner sein.
Die Plattform entfernt niemals Elemente aus der FutureAccessList für Sie. Wenn das Limit von 1.000 Elementen erreicht ist, können Sie kein weiteres hinzufügen, bis Sie mit der Methode Remove Platz geschaffen haben.

Freigeben über