StorageItemAccessList Clase

Definición

Espacio de nombres:

Windows.Storage.AccessCache

Representa la lista de acceso futuro de la aplicación (obtenida de la propiedad estática StorageApplicationPermissions.FutureAccessList ). Mediante la selección de archivos y carpetas, el usuario concede permiso a la aplicación para acceder a elementos que es posible que no estén disponibles de otro modo. Si agregas estos elementos a la lista de acceso futuro, podrás conservar este permiso cuando la aplicación desee tener acceso a ellos más tarde. Los elementos se almacenan en la lista de acceso futuro como objetos StorageFile y 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

Herencia

Object Platform::Object IInspectable StorageItemAccessList

Atributos

ContractVersionAttribute

Implementaciones

IStorageItemAccessList

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 para el 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 el uso del selector de archivos, consulte Abrir archivos y carpetas con un selector y Guardar un archivo con un selector.

Comentarios

Use esta lista de acceso futuro para conservar el acceso a archivos y ubicaciones que pueden no incluirse con las ubicaciones accesibles especificadas por las funcionalidades del manifiesto de la aplicación. Por ejemplo, si la aplicación usa un selector de archivos para tener acceso a un archivo (o ubicación), se recomienda almacenar el StorageFile que se devuelve desde el selector de archivos en esta lista de acceso futuro.

Esta lista puede almacenar hasta 1000 elementos y la aplicación debe mantenerla.

Para ver más ejemplos de código, consulte el ejemplo del 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 más información sobre los archivos y ubicaciones a las que la aplicación tiene permiso para acceder, consulte Permisos de acceso a archivos.

Propiedades

Entries	Obtiene un objeto para recuperar elementos de almacenamiento de la lista de acceso.
MaximumItemsAllowed	Obtiene el número máximo de elementos de almacenamiento que puede contener la lista de acceso.

Métodos

Add(IStorageItem)	Agrega un nuevo elemento de almacenamiento a la lista de acceso.
Add(IStorageItem, String)	Agrega un nuevo elemento de almacenamiento y metadatos complementarios a la lista de acceso.
AddOrReplace(String, IStorageItem)	Agrega un nuevo elemento de almacenamiento a la lista de acceso o reemplaza el elemento especificado si ya existe en la lista.
AddOrReplace(String, IStorageItem, String)	Agrega un nuevo elemento de almacenamiento y metadatos complementarios a la lista de acceso, o reemplaza el elemento especificado si ya existe en la lista.
CheckAccess(IStorageItem)	Determina si la aplicación tiene acceso al elemento de almacenamiento especificado en la lista de acceso.
Clear()	Quita todos los elementos de almacenamiento de la lista de acceso.
ContainsItem(String)	Determina si la lista de acceso contiene el elemento de almacenamiento especificado.
GetFileAsync(String)	Recupera el storageFile especificado de la lista.
GetFileAsync(String, AccessCacheOptions)	Recupera storageFile de la lista mediante las opciones especificadas.
GetFolderAsync(String)	Recupera el storageFolder especificado de la lista.
GetFolderAsync(String, AccessCacheOptions)	Recupera el storageFolder especificado de la lista mediante las opciones especificadas.
GetItemAsync(String)	Recupera el elemento especificado (como un archivo o carpeta) de la lista usada más recientemente (MRU).
GetItemAsync(String, AccessCacheOptions)	Recupera el elemento especificado (como un archivo o carpeta) de la lista mediante las opciones especificadas.
Remove(String)	Quita el elemento de almacenamiento especificado de la lista de acceso.

Consulte también

• FutureAccessList