StorageApplicationPermissions Clase

Definición

Espacio de nombres:

Windows.Storage.AccessCache

Proporciona propiedades estáticas para obtener la lista usada más recientemente de la aplicación (MRU) (use StorageApplicationPermissions.MostRecentlyUsedList) y la lista de acceso futuro (use 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

Herencia

Object Platform::Object IInspectable StorageApplicationPermissions

Atributos

ContractVersionAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra cómo agregar un elemento a FutureAccessList y MostRecentlyUsedList de la aplicación.

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

Se recomienda almacenar los tokens devueltos por StorageApplicationPermissions.MostRecentlyUsedList.Add y StorageApplicationPermissions.FutureAccessList.Add para poder usarlos para recuperar la entrada de lista correspondiente al elemento que agregó. En el ejemplo, almacenamos los tokens en mruToken y faToken , respectivamente, pero no hacemos nada más con ellos.

Además, la savePicker variable del ejemplo contiene un objeto FileSavePicker creado por el ejemplo. Para obtener más información sobre cómo guardar archivos con el selector de archivos, consulte Guardar un archivo con un selector. Para obtener información sobre el acceso a archivos, consulte Abrir archivos y carpetas con un selector.

Comentarios

Acceda estáticamente a los métodos y propiedades de esta clase.

Para ver más ejemplos de código, consulte el ejemplo selector de archivos y el ejemplo de acceso a archivos.

Para obtener información sobre el uso de FutureAccessList y MostRecentlyUsedList, consulte Seguimiento de archivos y carpetas usados recientemente.

Para obtener información sobre los archivos y las ubicaciones a las que la aplicación tiene permiso de acceso, consulte Permisos de acceso a archivos.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Propiedades

FutureAccessList	Obtiene un objeto que representa una lista que mantiene una aplicación para que la aplicación pueda almacenar archivos o ubicaciones (como carpetas) y acceder fácilmente a estos elementos en el futuro.
MostRecentlyUsedList	Obtiene un objeto que representa una lista que una aplicación puede usar para realizar un seguimiento de los archivos o ubicaciones (como carpetas) a las que ha accedido la aplicación más recientemente.

Métodos

GetFutureAccessListForUser(User)	Obtiene un objeto que representa una lista que mantiene una aplicación para que la aplicación pueda almacenar archivos o ubicaciones (como carpetas) y acceder fácilmente a estos elementos en el futuro. Este método devuelve un objeto cuyo ámbito es el usuario especificado. Use este método para aplicaciones multiusuario.
GetMostRecentlyUsedListForUser(User)	Obtiene un objeto que una aplicación puede usar para realizar un seguimiento de los archivos o ubicaciones (como carpetas) a los que ha accedido la aplicación más recientemente. Este método devuelve un objeto cuyo ámbito es el usuario especificado. Use este método para aplicaciones multiusuario.