Freigeben über


StorageItemMostRecentlyUsedList Klasse

Definition

Stellt die zuletzt verwendete Liste (MRU) Ihrer App dar (abgerufen aus der statischen StorageApplicationPermissions.MostRecentlyUsedList-Eigenschaft ). Sie verwenden Ihre MRU, um Elemente (Dateien und/oder Ordner) nachzuverfolgen, auf die der Benutzer zuletzt zugegriffen hat. Elemente werden in der MRU als StorageFile- und StorageFolder-Objekte gespeichert.

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
Vererbung
Object Platform::Object IInspectable StorageItemMostRecentlyUsedList
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird veranschaulicht, wie Sie der FutureAccessList und mostRecentlyUsedList der App ein Element hinzufügen.

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

Es wird empfohlen, die von StorageApplicationPermissions.MostRecentlyUsedList.Add und StorageApplicationPermissions.FutureAccessList.Add zurückgegebenen Token zu speichern, damit Sie sie verwenden können, um den entsprechenden Listeneintrag für das hinzugefügte Element abzurufen. Im Beispiel speichern wir die Token in mruToken bzw faToken ., aber wir machen nichts anderes mit ihnen.

Darüber hinaus enthält die savePicker Variable im Beispiel ein FileSavePicker-Objekt , das vom Beispiel erstellt wurde. Weitere Informationen zum Speichern von Dateien mit der Dateiauswahl finden Sie unter Speichern einer Datei mit einer Auswahl. Informationen zum Zugreifen auf Dateien finden Sie unter Öffnen von Dateien und Ordnern mit einer Auswahl.

Hinweise

Verwenden Sie die Zuletzt verwendete Liste (MRU), um Dateien und/oder Speicherorte nachzuverfolgen, auf die Ihr Benutzer häufig zugreift.

Diese Liste kann bis zu 25 Elemente speichern. Während die App Elemente zur MRU hinzufügen muss, um sie nachzuverfolgen, behält Windows den Grenzwert von 25 Elementen bei, indem es bei Bedarf veraltete Elemente entfernt.

Hinweis

Wenn Sie auf ItemRemoved-Ereignisse reagieren möchten, müssen Sie Ihren Ereignishandler jedes Mal registrieren, wenn Sie einen neuen Verweis auf die StorageItemMostRecentlyUsedList erhalten.

Weitere Codebeispiele finden Sie im Beispiel für die Dateiauswahl und im Dateizugriffsbeispiel.

Weitere Informationen zur Verwendung von FutureAccessList und MostRecentlyUsedList finden Sie unter Nachverfolgen zuletzt verwendeter Dateien und Ordner.

Weitere Informationen zu den Dateien und Speicherorten, auf die Ihre App zugreifen darf, finden Sie unter Dateizugriffsberechtigungen.

Eigenschaften

Entries

Ruft ein -Objekt zum Abrufen von Speicherelementen aus der Liste der zuletzt verwendeten (MRU) ab.

MaximumItemsAllowed

Ruft die maximale Anzahl von Speicherelementen ab, die die zuletzt verwendete Liste (MRU) enthalten kann.

Methoden

Add(IStorageItem)

Fügt der Liste der zuletzt verwendeten (MRU) ein neues Speicherelement hinzu.

Add(IStorageItem, String)

Fügt der Liste der zuletzt verwendeten (MRU) ein neues Speicherelement und zugehörige Metadaten hinzu.

Add(IStorageItem, String, RecentStorageItemVisibility)

Fügt der Liste der zuletzt verwendeten (MRU) ein neues Speicherelement und zugehörige Metadaten hinzu, wobei der Umfang seiner Sichtbarkeit in der Liste angegeben wird.

AddOrReplace(String, IStorageItem)

Fügt der Liste zuletzt verwendete (MRU) ein neues Speicherelement hinzu oder ersetzt das angegebene Element, wenn es bereits in der Liste vorhanden ist.

AddOrReplace(String, IStorageItem, String)

Fügt ein neues Speicherelement und begleitende Metadaten zur Liste der zuletzt verwendeten (MRU) hinzu oder ersetzt das angegebene Element, wenn es bereits in der Liste vorhanden ist.

AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)

Fügt ein neues Speicherelement und begleitende Metadaten zur Liste der zuletzt verwendeten (MRU) hinzu oder ersetzt das angegebene Element, wenn es bereits in der Liste vorhanden ist. Gibt auch den Umfang der Sichtbarkeit in der Liste an.

CheckAccess(IStorageItem)

Bestimmt, ob die App Zugriff auf das angegebene Speicherelement in der Liste der zuletzt verwendeten (MRU) hat.

Clear()

Entfernt alle Speicherelemente aus der Liste der zuletzt verwendeten (MRU).

ContainsItem(String)

Bestimmt, ob die Zuletzt verwendete Liste (MRU) das angegebene Speicherelement enthält.

GetFileAsync(String)

Ruft die angegebene storageFile-Datei aus der Liste der zuletzt verwendeten (MRU) ab.

GetFileAsync(String, AccessCacheOptions)

Ruft die angegebene storageFile aus der Liste der zuletzt verwendeten (MRU) mithilfe der angegebenen Optionen ab.

GetFolderAsync(String)

Ruft den angegebenen StorageFolder aus der Liste der zuletzt verwendeten (MRU) ab.

GetFolderAsync(String, AccessCacheOptions)

Ruft den angegebenen StorageFolder mithilfe der angegebenen Optionen aus der Liste der zuletzt verwendeten (MRU) ab.

GetItemAsync(String)

Ruft das angegebene Element (z. B. eine Datei oder einen Ordner) aus der Liste der zuletzt verwendeten (MRU) ab.

GetItemAsync(String, AccessCacheOptions)

Ruft das angegebene Element (z. B. eine Datei oder einen Ordner) aus der Liste der zuletzt verwendeten (MRU) mithilfe der angegebenen Optionen ab.

Remove(String)

Entfernt das angegebene Speicherelement aus der Liste der zuletzt verwendeten (MRU).

Ereignisse

ItemRemoved

Wird ausgelöst, wenn ein Speicherelement aus der Liste der zuletzt verwendeten (MRU) entfernt wird.

Gilt für:

Weitere Informationen