StorageItemMostRecentlyUsedList Classe

Définition

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

Héritage

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

Attributs

ContractVersionAttribute

Implémente

IStorageItemAccessList

Configuration requise pour Windows

Exemples

Cet exemple montre comment ajouter un élément aux listes FutureAccessList et MostRecentlyUsedList de l’application.

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

Nous vous recommandons de stocker les jetons retournés par StorageApplicationPermissions.MostRecentlyUsedList.Add et StorageApplicationPermissions.FutureAccessList.Add afin de pouvoir les utiliser pour récupérer l’entrée de liste respective pour l’élément que vous avez ajouté. Dans l’exemple, nous stockons les jetons dans mruToken et faToken respectivement, mais nous ne faisons rien d’autre avec eux.

En outre, la savePicker variable de l’exemple contient un objet FileSavePicker qui a été créé par l’exemple. Pour en savoir plus sur l’enregistrement de fichiers avec le sélecteur de fichiers, consultez Enregistrer un fichier avec un sélecteur. Pour en savoir plus sur l’accès aux fichiers, consultez Ouvrir des fichiers et des dossiers avec un sélecteur.

Remarques

Utilisez la liste la plus récente utilisée (MRU) pour suivre les fichiers et/ou les emplacements auxquels votre utilisateur accède fréquemment.

Cette liste peut stocker jusqu’à 25 éléments. Alors que l’application doit ajouter des éléments à l’MRU pour les suivre, Windows maintient la limite de 25 éléments en supprimant les éléments obsolètes si nécessaire.

Pour afficher d’autres exemples de code, consultez l’exemple sélecteur de fichiers et l’exemple Accès aux fichiers.

Pour en savoir plus sur l’utilisation de FutureAccessList et MostRecentlyUsedList, consultez Suivre les fichiers et dossiers récemment utilisés.

Pour en savoir plus sur les fichiers et emplacements auxquels votre application est autorisée à accéder, consultez Autorisations d’accès aux fichiers.

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• MostRecentlyUsedList