StorageItemMostRecentlyUsedList Clase

Definición

Espacio de nombres:

Windows.Storage.AccessCache

Representa la lista usada más recientemente de la aplicación (MRU) (obtenida de la propiedad estática StorageApplicationPermissions.MostRecentlyUsedList ). Usa su MRU para realizar un seguimiento de los elementos (archivos o carpetas) a los que el usuario ha accedido más recientemente. Los elementos se almacenan en mrU como objetos StorageFile y StorageFolder .

public ref class StorageItemMostRecentlyUsedList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemMostRecentlyUsedList final

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

Public NotInheritable Class StorageItemMostRecentlyUsedList

Herencia

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

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

Use la lista usada más recientemente (MRU) para realizar un seguimiento de archivos o ubicaciones a las que el usuario accede con frecuencia.

Esta lista puede almacenar hasta 25 elementos. Aunque la aplicación debe agregar elementos a mrU para realizar un seguimiento de ellos, Windows mantiene el límite de 25 elementos quitando elementos obsoletos si es necesario.

Nota

Si desea responder a los eventos ItemRemoved , debe registrar el controlador de eventos cada vez que obtenga una nueva referencia a StorageItemMostRecentlyUsedList.

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 más información sobre los archivos y las ubicaciones a las que la aplicación tiene permiso de acceso, consulte Permisos de acceso a archivos.

Propiedades

Entries	Obtiene un objeto para recuperar elementos de almacenamiento de la lista usada más recientemente (MRU).
MaximumItemsAllowed	Obtiene el número máximo de elementos de almacenamiento que puede contener la lista usada más recientemente (MRU).

Métodos

Add(IStorageItem)	Agrega un nuevo elemento de almacenamiento a la lista usada más recientemente (MRU).
Add(IStorageItem, String)	Agrega un nuevo elemento de almacenamiento y los metadatos complementarios a la lista de mru (MRU) usada más recientemente.
Add(IStorageItem, String, RecentStorageItemVisibility)	Agrega un nuevo elemento de almacenamiento y metadatos complementarios a la lista usada más recientemente (MRU), especificando la extensión de su visibilidad en la lista.
AddOrReplace(String, IStorageItem)	Agrega un nuevo elemento de almacenamiento a la lista usada más recientemente (MRU), 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 usada más recientemente (MRU), o reemplaza el elemento especificado si ya existe en la lista.
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	Agrega un nuevo elemento de almacenamiento y metadatos complementarios a la lista usada más recientemente (MRU), o reemplaza el elemento especificado si ya existe en la lista. Especifica también la extensión de su visibilidad en la lista.
CheckAccess(IStorageItem)	Determina si la aplicación tiene acceso al elemento de almacenamiento especificado en la lista usada más recientemente (MRU).
Clear()	Quita todos los elementos de almacenamiento de la lista usada más recientemente (MRU).
ContainsItem(String)	Determina si la lista usada más recientemente (MRU) contiene el elemento de almacenamiento especificado.
GetFileAsync(String)	Recupera el storageFile especificado de la lista usada más recientemente (MRU).
GetFileAsync(String, AccessCacheOptions)	Recupera el storageFile especificado de la lista usada más recientemente (MRU) mediante las opciones especificadas.
GetFolderAsync(String)	Recupera la instancia de StorageFolder especificada de la lista usada más recientemente (MRU).
GetFolderAsync(String, AccessCacheOptions)	Recupera el storageFolder especificado de la lista usada más recientemente (MRU) 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 una carpeta) de la lista usada más recientemente (MRU) mediante las opciones especificadas.
Remove(String)	Quita el elemento de almacenamiento especificado de la lista usada más recientemente (MRU).

Eventos

ItemRemoved

Se desencadena cuando se quita un elemento de almacenamiento de la lista de mru (MRU) usada más recientemente.

Consulte también

• MostRecentlyUsedList