StorageItemMostRecentlyUsedList class

Represents a list that an app can use to track the files and/or locations (like folders) that the app has accessed most recently. Files and locations are stored in this most recently used (MRU) list are represented by StorageFile and StorageFolder objects, respectively.

Syntax

Public NotInheritable Class StorageItemMostRecentlyUsedList  
    Inherits Object
    Implements IStorageItemAccessList

Attributes

VersionAttribute(NTDDI_WIN8)

Members

The StorageItemMostRecentlyUsedList class has these types of members:

• Events
• Methods
• Properties

Events

The StorageItemMostRecentlyUsedList class has these events.

Methods

The StorageItemMostRecentlyUsedList class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Properties

The StorageItemMostRecentlyUsedList class has these properties.

Remarks

Use the 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 and permissions in Windows Store apps.

Examples

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

We recommend that you store the tokens that are returned by StorageApplicationPermissions.MostRecentlyUsedList.Add and StorageApplicationPermissions.FutureAccessList.Add 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 pickers, see How to save files through file pickers. To learn about accessing files, see Quickstart: Accessing files with file pickers.

Requirements

See also

StorageItemMostrecentlyUsedList.mostRecentlyUsedList property

Build date: 12/4/2012