StorageItemMostRecentlyUsedList StorageItemMostRecentlyUsedList StorageItemMostRecentlyUsedList StorageItemMostRecentlyUsedList Class

Definition

Represents your app's most recently used list (MRU) (obtained from the static MostRecentlyUsedList property). You use your MRU to track items (files and/or folders) that the user has accessed most recently. Items are stored in the MRU as StorageFile and StorageFolder objects.

public sealed class StorageItemMostRecentlyUsedListpublic sealed class StorageItemMostRecentlyUsedListPublic NotInheritable Class StorageItemMostRecentlyUsedListpublic sealed class StorageItemMostRecentlyUsedList
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Use the most recently used (MRU) list to track files and/or locations that your user accesses frequently.

This list can store up to 25 items. While the app must add items to the MRU in order to track them, Windows maintains the 25-item limit by removing stale items if necessary.

Note

If you want to respond to ItemRemoved events you must register your event handle every time you get a new reference to the StorageItemMostRecentlyUsedList.

To see more code examples, see the File picker sample and the File access sample.

To learn about using the FutureAccessList and MostRecentlyUsedList, see How to track recently used files and folders.

To learn more about what files and locations your app has permission to access, see File access permissions.

Examples

This example demonstrates how to add an item to the app's FutureAccessList and MostRecentlyUsedList.

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
}
savePicker.pickSaveFileAsync().then(function (file) {
    if (file) {
        // Add to MRU with metadata (For example, a string that represents the date)
        var mruToken = StorageApplicationPermissions.mostRecentlyUsedList.add(file, "20120716");

        // Add to FA without metadata
        var faToken = Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.add(file);
    } else {
        // The file picker was dismissed with no file selected to save
    }
});

We recommend that you store the tokens that are returned by Add(IStorageItem) and Add(IStorageItem) so that you can use them to retrieve the respective list entry for the item that you added. In the example, we store the tokens in mruToken and faToken respectively but we don't do anything else with them.

Additionally, the savePicker variable in the example contains a FileSavePicker object that was created by the sample. To learn more about saving files with file picker, see How to save files through . To learn about accessing files, see Quickstart: Accessing files with .

Properties

Entries Entries Entries Entries

Gets an object for retrieving storage items from the most recently used (MRU) list.

public AccessListEntryView Entries { get; }public AccessListEntryView Entries { get; }Public ReadOnly Property Entries As AccessListEntryViewpublic AccessListEntryView Entries { get; }
Value
AccessListEntryView AccessListEntryView AccessListEntryView AccessListEntryView

The object for retrieving storage items.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

MaximumItemsAllowed MaximumItemsAllowed MaximumItemsAllowed MaximumItemsAllowed

Gets the maximum number of storage items that the most recently used (MRU) list can contain.

public uint MaximumItemsAllowed { get; }public uint MaximumItemsAllowed { get; }Public ReadOnly Property MaximumItemsAllowed As uintpublic uint MaximumItemsAllowed { get; }
Value
uint uint uint uint

The maximum number of storage items.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Methods

Add(IStorageItem) Add(IStorageItem) Add(IStorageItem) Add(IStorageItem)

Adds a new storage item to the most recently used (MRU) list.

public string Add(IStorageItem file)public string Add(IStorageItem file)Public Function Add(file As IStorageItem) As stringpublic string Add(IStorageItem file)
Parameters
file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to add.

Returns
string string string string

A token that the app can use later to retrieve the storage item.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Add(IStorageItem, String) Add(IStorageItem, String) Add(IStorageItem, String) Add(IStorageItem, String)

Adds a new storage item and accompanying metadata to the most recently used (MRU) list.

public string Add(IStorageItem file, String metadata)public string Add(IStorageItem file, String metadata)Public Function Add(file As IStorageItem, metadata As String) As stringpublic string Add(IStorageItem file, String metadata)
Parameters
file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to add.

metadata
System.String System.String System.String System.String

Optional metadata to associate with the storage item.

Returns
string string string string

A token that the app can use later to retrieve the storage item.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Add(IStorageItem, String, RecentStorageItemVisibility) Add(IStorageItem, String, RecentStorageItemVisibility) Add(IStorageItem, String, RecentStorageItemVisibility) Add(IStorageItem, String, RecentStorageItemVisibility)

Adds a new storage item and accompanying metadata to the most recently used (MRU) list, specifying the extent of its visibility in the list.

public string Add(IStorageItem file, String metadata, RecentStorageItemVisibility visibility)public string Add(IStorageItem file, String metadata, RecentStorageItemVisibility visibility)Public Function Add(file As IStorageItem, metadata As String, visibility As RecentStorageItemVisibility) As stringpublic string Add(IStorageItem file, String metadata, RecentStorageItemVisibility visibility)
Parameters
file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to add.

metadata
System.String System.String System.String System.String

Optional metadata to associate with the storage item.

visibility
RecentStorageItemVisibility RecentStorageItemVisibility RecentStorageItemVisibility RecentStorageItemVisibility

The extent of the visibility of the storage item in the list.

Returns
string string string string

A token that the app can use later to retrieve the storage item.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

AddOrReplace(String, IStorageItem) AddOrReplace(String, IStorageItem) AddOrReplace(String, IStorageItem) AddOrReplace(String, IStorageItem)

Adds a new storage item to the most recently used (MRU) list, or replaces the specified item if it already exists in the list.

public void AddOrReplace(String token, IStorageItem file)public void AddOrReplace(String token, IStorageItem file)Public Function AddOrReplace(token As String, file As IStorageItem) As voidpublic void AddOrReplace(String token, IStorageItem file)
Parameters
token
System.String System.String System.String System.String

The token associated with the new storage item. If the access list already contains a storage item that has this token, the new item replaces the existing one.

file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to add or replace.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

AddOrReplace(String, IStorageItem, String) AddOrReplace(String, IStorageItem, String) AddOrReplace(String, IStorageItem, String) AddOrReplace(String, IStorageItem, String)

Adds a new storage item and accompanying metadata to the most recently used (MRU) list, or replaces the specified item if it already exists in the list.

public void AddOrReplace(String token, IStorageItem file, String metadata)public void AddOrReplace(String token, IStorageItem file, String metadata)Public Function AddOrReplace(token As String, file As IStorageItem, metadata As String) As voidpublic void AddOrReplace(String token, IStorageItem file, String metadata)
Parameters
token
System.String System.String System.String System.String

The token associated with the new storage item. If the access list already contains a storage item that has this token, the new item replaces the existing one.

file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to add or replace.

metadata
System.String System.String System.String System.String

Optional metadata to associate with the storage item.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility) AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility) AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility) AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)

Adds a new storage item and accompanying metadata to the most recently used (MRU) list, or replaces the specified item if it already exists in the list. Also specifies the extent of its visibility in the list.

public void AddOrReplace(String token, IStorageItem file, String metadata, RecentStorageItemVisibility visibility)public void AddOrReplace(String token, IStorageItem file, String metadata, RecentStorageItemVisibility visibility)Public Function AddOrReplace(token As String, file As IStorageItem, metadata As String, visibility As RecentStorageItemVisibility) As voidpublic void AddOrReplace(String token, IStorageItem file, String metadata, RecentStorageItemVisibility visibility)
Parameters
token
System.String System.String System.String System.String

The token associated with the new storage item. If the access list already contains a storage item that has this token, the new item replaces the existing one.

file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to add or replace.

metadata
System.String System.String System.String System.String

Optional metadata to associate with the storage item.

visibility
RecentStorageItemVisibility RecentStorageItemVisibility RecentStorageItemVisibility RecentStorageItemVisibility

The extent of the visibility of the storage item in the list.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

CheckAccess(IStorageItem) CheckAccess(IStorageItem) CheckAccess(IStorageItem) CheckAccess(IStorageItem)

Determines whether the app has access to the specified storage item in the most recently used (MRU) list.

public bool CheckAccess(IStorageItem file)public bool CheckAccess(IStorageItem file)Public Function CheckAccess(file As IStorageItem) As boolpublic bool CheckAccess(IStorageItem file)
Parameters
file
IStorageItem IStorageItem IStorageItem IStorageItem

The storage item to check for access.

Returns
bool bool bool bool

True if the app can access the storage item; otherwise false.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Clear() Clear() Clear() Clear()

Removes all storage items from the most recently used (MRU) list.

public void Clear()public void Clear()Public Function Clear() As voidpublic void Clear()
Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

ContainsItem(String) ContainsItem(String) ContainsItem(String) ContainsItem(String)

Determines whether the most recently used (MRU) list contains the specified storage item.

public bool ContainsItem(String token)public bool ContainsItem(String token)Public Function ContainsItem(token As String) As boolpublic bool ContainsItem(String token)
Parameters
token
System.String System.String System.String System.String

The token of the storage item to look for.

Returns
bool bool bool bool

True if the most recently used (MRU) list contains the specified storage item; false otherwise.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

GetFileAsync(String) GetFileAsync(String) GetFileAsync(String) GetFileAsync(String)

Retrieves the specified StorageFile from the most recently used (MRU) list.

public IAsyncOperation<StorageFile> GetFileAsync(String token)public IAsyncOperation<StorageFile> GetFileAsync(String token)Public Function GetFileAsync(token As String) As IAsyncOperation( Of StorageFile )public IAsyncOperation<StorageFile> GetFileAsync(String token)
Parameters
token
System.String System.String System.String System.String

The token of the StorageFile to retrieve.

Returns

When this method completes successfully, it returns the StorageFile that is associated with the specified token.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

GetFileAsync(String, AccessCacheOptions) GetFileAsync(String, AccessCacheOptions) GetFileAsync(String, AccessCacheOptions) GetFileAsync(String, AccessCacheOptions)

Retrieves the specified StorageFile from the most recently used (MRU) list using the specified options.

public IAsyncOperation<StorageFile> GetFileAsync(String token, AccessCacheOptions options)public IAsyncOperation<StorageFile> GetFileAsync(String token, AccessCacheOptions options)Public Function GetFileAsync(token As String, options As AccessCacheOptions) As IAsyncOperation( Of StorageFile )public IAsyncOperation<StorageFile> GetFileAsync(String token, AccessCacheOptions options)
Parameters
token
System.String System.String System.String System.String

The token of the StorageFile to retrieve.

options
AccessCacheOptions AccessCacheOptions AccessCacheOptions AccessCacheOptions

The enum value that describes the behavior to use when the app accesses the item.

Returns

When this method completes successfully, it returns the StorageFile that is associated with the specified token.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

GetFolderAsync(String) GetFolderAsync(String) GetFolderAsync(String) GetFolderAsync(String)

Retrieves the specified StorageFolder from the most recently used (MRU) list.

public IAsyncOperation<StorageFolder> GetFolderAsync(String token)public IAsyncOperation<StorageFolder> GetFolderAsync(String token)Public Function GetFolderAsync(token As String) As IAsyncOperation( Of StorageFolder )public IAsyncOperation<StorageFolder> GetFolderAsync(String token)
Parameters
token
System.String System.String System.String System.String

The token of the StorageFolder to retrieve.

Returns

When this method completes successfully, it returns the StorageFolder that is associated with the specified token.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

GetFolderAsync(String, AccessCacheOptions) GetFolderAsync(String, AccessCacheOptions) GetFolderAsync(String, AccessCacheOptions) GetFolderAsync(String, AccessCacheOptions)

Retrieves the specified StorageFolder from the most recently used (MRU) list using the specified options.

public IAsyncOperation<StorageFolder> GetFolderAsync(String token, AccessCacheOptions options)public IAsyncOperation<StorageFolder> GetFolderAsync(String token, AccessCacheOptions options)Public Function GetFolderAsync(token As String, options As AccessCacheOptions) As IAsyncOperation( Of StorageFolder )public IAsyncOperation<StorageFolder> GetFolderAsync(String token, AccessCacheOptions options)
Parameters
token
System.String System.String System.String System.String

The token of the StorageFolder to retrieve.

options
AccessCacheOptions AccessCacheOptions AccessCacheOptions AccessCacheOptions

The enum value that describes the behavior to use when the app accesses the item.

Returns

When this method completes successfully, it returns the StorageFolder that is associated with the specified token.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

GetItemAsync(String) GetItemAsync(String) GetItemAsync(String) GetItemAsync(String)

Retrieves the specified item (like a file or folder) from the most recently used (MRU) list.

public IAsyncOperation<IStorageItem> GetItemAsync(String token)public IAsyncOperation<IStorageItem> GetItemAsync(String token)Public Function GetItemAsync(token As String) As IAsyncOperation( Of IStorageItem )public IAsyncOperation<IStorageItem> GetItemAsync(String token)
Parameters
token
System.String System.String System.String System.String

The token of the item to retrieve.

Returns

When this method completes successfully, it returns the item (type IStorageItem ) that is associated with the specified token.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

GetItemAsync(String, AccessCacheOptions) GetItemAsync(String, AccessCacheOptions) GetItemAsync(String, AccessCacheOptions) GetItemAsync(String, AccessCacheOptions)

Retrieves the specified item (like a file or folder) from the most recently used (MRU) list using the specified options.

public IAsyncOperation<IStorageItem> GetItemAsync(String token, AccessCacheOptions options)public IAsyncOperation<IStorageItem> GetItemAsync(String token, AccessCacheOptions options)Public Function GetItemAsync(token As String, options As AccessCacheOptions) As IAsyncOperation( Of IStorageItem )public IAsyncOperation<IStorageItem> GetItemAsync(String token, AccessCacheOptions options)
Parameters
token
System.String System.String System.String System.String

The token of the item to retrieve.

options
AccessCacheOptions AccessCacheOptions AccessCacheOptions AccessCacheOptions

The enum value that describes the behavior to use when the app accesses the item.

Returns

When this method completes successfully, it returns the item (type IStorageItem ) that is associated with the specified token.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remove(String) Remove(String) Remove(String) Remove(String)

Removes the specified storage item from the most recently used (MRU) list.

public void Remove(String token)public void Remove(String token)Public Function Remove(token As String) As voidpublic void Remove(String token)
Parameters
token
System.String System.String System.String System.String

The token of the storage item to remove.

Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Events

ItemRemoved ItemRemoved ItemRemoved ItemRemoved

Fires when a storage item is removed from the most recently used (MRU) list.

public event TypedEventHandler ItemRemovedpublic event TypedEventHandler ItemRemovedPublic Event ItemRemovedpublic event TypedEventHandler ItemRemoved
Attributes
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

Note

If you want to respond to ItemRemoved events you must register your event handle every time you get a new reference to the StorageItemMostRecentlyUsedList.