StorageItemMostRecentlyUsedList Klasse

Definition

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

ContractVersionAttribute

Implementiert

IStorageItemAccessList

Windows-Anforderungen

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.

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

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• MostRecentlyUsedList