StorageItemAccessList Classe

Définition

Espace de noms:

Windows.Storage.AccessCache

Représente la liste d’accès futur de votre application (obtenue à partir de la propriété StorageApplicationPermissions.FutureAccessList statique). En sélectionnant des fichiers et dossiers, votre utilisateur autorise votre application à accéder à des éléments qui pourraient ne pas être accessibles autrement. En ajoutant ces éléments à votre liste d'accès futurs, vous conservez cette autorisation au cas où votre application devrait accéder à ces éléments ultérieurement. Les éléments sont stockés dans la liste d’accès futur en tant qu’objets StorageFile et StorageFolder .

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

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

Entries	Obtient un objet pour récupérer des éléments de stockage à partir de la liste d’accès.
MaximumItemsAllowed	Obtient le nombre maximal d’éléments de stockage que la liste d’accès peut contenir.

Méthodes

Add(IStorageItem)	Ajoute un nouvel élément de stockage à la liste d’accès.
Add(IStorageItem, String)	Ajoute un nouvel élément de stockage et les métadonnées associées à la liste d’accès.
AddOrReplace(String, IStorageItem)	Ajoute un nouvel élément de stockage à la liste d’accès 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 d’accès, ou remplace l’élément spécifié s’il existe déjà dans la liste.
CheckAccess(IStorageItem)	Détermine si l’application a accès à l’élément de stockage spécifié dans la liste d’accès.
Clear()	Supprime tous les éléments de stockage de la liste d’accès.
ContainsItem(String)	Détermine si la liste d’accès contient l’élément de stockage spécifié.
GetFileAsync(String)	Récupère le StorageFile spécifié à partir de la liste.
GetFileAsync(String, AccessCacheOptions)	Récupère le StorageFile de la liste à l’aide des options spécifiées.
GetFolderAsync(String)	Récupère le StorageFolder spécifié à partir de la liste.
GetFolderAsync(String, AccessCacheOptions)	Récupère le StorageFolder spécifié à partir de la liste à 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) de la liste à l’aide des options spécifiées.
Remove(String)	Supprime l’élément de stockage spécifié de la liste d’accès.

Voir aussi

• FutureAccessList