StorageItemMostRecentlyUsedList.Add(IStorageItem) | add(IStorageItem) method

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

Syntax

var string = storageItemMostRecentlyUsedList.add(file);

Parameters

file

Type: IStorageItem

The storage item to add.

Return value

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

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

Examples

This example shows you how to use this Add method of the MRU list to store a file that was picked by the user so that you can keep track of the users most recently used files.

var openPicker = new Windows.Storage.Pickers.FileOpenPicker();
openPicker.pickSingleFileAsync().then(function (pickedFile) {
    if (pickedFile) {
        // Store the file to access again later
        var listToken = Windows.Storage.AccessCache.StorageApplicationPermissions.mostRecentlyUsedList.add(pickedFile);

        // Add code to process the file that the user picked
    } else {
        // No file
    }
});

Make sure you check that a file was picked before you process the pickedFile (a StorageFile object), as shown in the example.

Requirements

See also

StorageItemMostRecentlyUsedList

Add(IStorageItem, String)

Build date: 12/4/2012