StorageItemMostRecentlyUsedList Classe

Référence

Définition

Espace de noms:: Windows.Storage.AccessCache

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente la liste la plus récente utilisée de votre application (MRU) (obtenue à partir de la propriété StorageApplicationPermissions.MostRecentlyUsedList statique). Vous utilisez votre MRU pour suivre les éléments (fichiers et/ou dossiers) auxquels l’utilisateur a accédé récemment. Les éléments sont stockés dans le MRU en tant qu’objets StorageFile et StorageFolder .

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

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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.

Notes

Si vous souhaitez répondre aux événements ItemRemoved , vous devez inscrire votre gestionnaire d’événements chaque fois que vous obtenez une nouvelle référence à StorageItemMostRecentlyUsedList.

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

Entries	Obtient un objet permettant de récupérer des éléments de stockage de la liste la plus récente utilisée (MRU).
MaximumItemsAllowed	Obtient le nombre maximal d’éléments de stockage que la liste la plus récente utilisée (MRU) peut contenir.

Méthodes

Add(IStorageItem)	Ajoute un nouvel élément de stockage à la liste la plus récente utilisée (MRU).
Add(IStorageItem, String)	Ajoute un nouvel élément de stockage et les métadonnées associées à la liste la plus récente utilisée (MRU).
Add(IStorageItem, String, RecentStorageItemVisibility)	Ajoute un nouvel élément de stockage et des métadonnées associées à la liste la plus récente utilisée (MRU), en spécifiant l’étendue de sa visibilité dans la liste.
AddOrReplace(String, IStorageItem)	Ajoute un nouvel élément de stockage à la liste la plus récente utilisée (MRU) ou remplace l’élément spécifié s’il existe déjà dans la liste.
AddOrReplace(String, IStorageItem, String)	Ajoute un nouvel élément de stockage et les métadonnées associées à la liste la plus récemment utilisée (MRU), ou remplace l’élément spécifié s’il existe déjà dans la liste.
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	Ajoute un nouvel élément de stockage et les métadonnées associées à la liste la plus récemment utilisée (MRU), ou remplace l’élément spécifié s’il existe déjà dans la liste. Spécifie également l’étendue de sa visibilité dans la liste.
CheckAccess(IStorageItem)	Détermine si l’application a accès à l’élément de stockage spécifié dans la liste la plus récente utilisée (MRU).
Clear()	Supprime tous les éléments de stockage de la liste la plus récente utilisée (MRU).
ContainsItem(String)	Détermine si la liste la plus récente utilisée (MRU) contient l’élément de stockage spécifié.
GetFileAsync(String)	Récupère le storageFile spécifié à partir de la liste la plus récente utilisée (MRU).
GetFileAsync(String, AccessCacheOptions)	Récupère le storageFile spécifié à partir de la liste la plus récente utilisée (MRU) à l’aide des options spécifiées.
GetFolderAsync(String)	Récupère le StorageFolder spécifié à partir de la liste la plus récente utilisée (MRU).
GetFolderAsync(String, AccessCacheOptions)	Récupère le StorageFolder spécifié à partir de la liste la plus récente utilisée (MRU) à l’aide des options spécifiées.
GetItemAsync(String)	Récupère l’élément spécifié (comme un fichier ou un dossier) à partir de la liste la plus récente utilisée (MRU).
GetItemAsync(String, AccessCacheOptions)	Récupère l’élément spécifié (comme un fichier ou un dossier) à partir de la liste la plus récente utilisée (MRU) à l’aide des options spécifiées.
Remove(String)	Supprime l’élément de stockage spécifié de la liste la plus récente utilisée (MRU).

Événements

ItemRemoved

Se déclenche lorsqu’un élément de stockage est supprimé de la liste la plus récente utilisée (MRU).

S’applique à

Voir aussi

MostRecentlyUsedList