Skip to main content
StorageItemMostRecentlyUsedList.AddOrReplace(String, IStorageItem, String) | addOrReplace(String, IStorageItem, String) method

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.

Syntax


storageItemMostRecentlyUsedList.addOrReplace(token, file, metadata);

public void AddOrReplace(
  string token, 
  IStorageItem file, 
  string metadata
)

Public Sub AddOrReplace(
  token As String,  
  file As IStorageItem,  
  metadata As String 
)

public:
void AddOrReplace(
  String^ token, 
  IStorageItem^ file, 
  String^ metadata
)

Parameters

token

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

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

Type: IStorageItem

The storage item to add or replace.

metadata

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

Optional metadata to associate with the storage item.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Storage.AccessCache
Windows::Storage::AccessCache [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Storage.AccessCache
Windows::Storage::AccessCache [C++]

Metadata

Windows.winmd

See also

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