StorageItemAccessList Classe

Définition

public ref class StorageItemAccessList sealed : IStorageItemAccessList

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemAccessList final : IStorageItemAccessList

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemAccessList : IStorageItemAccessList

Public NotInheritable Class StorageItemAccessList
Implements IStorageItemAccessList

Héritage

Object Platform::Object IInspectable StorageItemAccessList

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’utilisation du sélecteur de fichiers, consultez Ouvrir des fichiers et des dossiers avec un sélecteur et Enregistrer un fichier avec un sélecteur.

Remarques

Utilisez cette liste d’accès futur pour conserver l’accès aux fichiers et aux emplacements qui peuvent ne pas être inclus dans les emplacements accessibles spécifiés par les fonctionnalités dans le manifeste de votre application. Par exemple, si votre application utilise un sélecteur de fichiers pour accéder à un fichier (ou à un emplacement), nous vous recommandons de stocker le StorageFile retourné à partir du sélecteur de fichiers dans cette liste d’accès futur.

Cette liste peut stocker jusqu’à 1 000 éléments et doit être gérée par l’application.

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

S’applique à

Voir aussi

• FutureAccessList