StorageApplicationPermissions Classe

Définition

Espace de noms:

Windows.Storage.AccessCache

Fournit des propriétés statiques permettant d’obtenir la liste la plus récente utilisée (MRU) de votre application (utiliser StorageApplicationPermissions.MostRecentlyUsedList) et la liste d’accès futur (utilisez StorageApplicationPermissions.FutureAccessList.

public ref class StorageApplicationPermissions abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageApplicationPermissions final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class StorageApplicationPermissions

Public Class StorageApplicationPermissions

Héritage

Object Platform::Object IInspectable StorageApplicationPermissions

Attributs

ContractVersionAttribute

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

Il est recommandé 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

Accédez statiquement aux méthodes et propriétés de cette classe.

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 les emplacements auxquels votre application est autorisée à accéder, consultez Autorisations d’accès aux fichiers.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Propriétés

FutureAccessList	Obtient un objet qui représente une liste qu’une application gère afin que l’application puisse stocker des fichiers et/ou des emplacements (tels que des dossiers) et accéder facilement à ces éléments à l’avenir.
MostRecentlyUsedList	Obtient un objet qui représente une liste qu’une application peut utiliser pour suivre les fichiers et/ou les emplacements (tels que les dossiers) auxquels l’application a accédé récemment.

Méthodes

GetFutureAccessListForUser(User)	Obtient un objet qui représente une liste qu’une application gère afin que l’application puisse stocker des fichiers et/ou des emplacements (tels que des dossiers) et accéder facilement à ces éléments à l’avenir. Cette méthode retourne un objet dont l’étendue est limitée à l’utilisateur spécifié. Utilisez cette méthode pour les applications multi-utilisateurs.
GetMostRecentlyUsedListForUser(User)	Obtient un objet qu’une application peut utiliser pour suivre les fichiers et/ou les emplacements (tels que les dossiers) auxquels l’application a accédé le plus récemment. Cette méthode retourne un objet dont l’étendue est limitée à l’utilisateur spécifié. Utilisez cette méthode pour les applications multi-utilisateurs.