StorageApplicationPermissions Classe

Définition

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

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

Propriétés

Méthodes

S’applique à