StorageItemMostRecentlyUsedList クラス

リファレンス

定義

名前空間:: Windows.Storage.AccessCache

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

アプリの最近使用したリスト (MRU) を表します (静的 StorageApplicationPermissions.MostRecentlyUsedList プロパティから取得)。 MRU を使用して、ユーザーが最近アクセスしたアイテム (ファイルやフォルダー) を追跡します。項目は、 StorageFile オブジェクトと StorageFolder オブジェクトとして MRU に格納されます。

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

継承: Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

属性: ContractVersionAttribute

実装: IStorageItemAccessList

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

この例では、アプリの FutureAccessList と 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
}

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

StorageApplicationPermissions.MostRecentlyUsedList.Add および StorageApplicationPermissions.FutureAccessList.Add によって返されるトークンを格納して、追加したアイテムのそれぞれのリストエントリを取得できるようにすることをお勧めします。この例では、トークンをそれぞれにmruTokenfaToken格納しますが、他の処理は行いません。

さらに、この例の savePicker 変数には、サンプルによって作成された FileSavePicker オブジェクトが含まれています。ファイルピッカーを使用してファイルを保存する方法の詳細については、「ピッカーを使用してファイルを保存する」を参照してください。ファイルへのアクセスの詳細については、「ピッカーを使用してファイルとフォルダーを開く」を参照してください。

注釈

最近使用した (MRU) リストを使用して、ユーザーが頻繁にアクセスするファイルや場所を追跡します。

このリストには、最大 25 個のアイテムを格納できます。アプリはそれらを追跡するために MRU に項目を追加する必要があります。一方、Windows では、必要に応じて古い項目を削除することで 25 項目の制限を維持します。

注意

ItemRemoved イベントに応答する場合は、StorageItemMostRecentlyUsedList への新しい参照を取得するたびに、イベントハンドラーを登録する必要があります。

その他のコード例については、ファイルピッカーのサンプルとファイルアクセスのサンプルに関するページを参照してください。

FutureAccessList と MostRecentlyUsedList の使用については、「最近使用したファイルとフォルダーを追跡する」を参照してください。

アプリがアクセス許可を持つファイルと場所の詳細については、「ファイルアクセス許可」を参照してください。

プロパティ

Entries	最後に使用した (MRU) リストからストレージ項目を取得するためのオブジェクトを取得します。
MaximumItemsAllowed	最近使用した (MRU) リストに含めることができるストレージ項目の最大数を取得します。

メソッド

Add(IStorageItem)	最近使用した (MRU) リストに新しいストレージ項目を追加します。
Add(IStorageItem, String)	新しいストレージ項目と付随するメタデータを、最近使用した (MRU) リストに追加します。
Add(IStorageItem, String, RecentStorageItemVisibility)	新しいストレージ項目とそれに付随するメタデータを、最近使用した (MRU) リストに追加し、リスト内の可視性の範囲を指定します。
AddOrReplace(String, IStorageItem)	最近使用した (MRU) リストに新しいストレージ項目を追加するか、指定した項目がリストに既に存在する場合は置き換えます。
AddOrReplace(String, IStorageItem, String)	新しいストレージ項目と付随するメタデータを最近使用した (MRU) リストに追加するか、指定した項目がリストに既に存在する場合は置き換えます。
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	新しいストレージ項目と付随するメタデータを最近使用した (MRU) リストに追加するか、指定した項目がリストに既に存在する場合は置き換えます。また、リスト内の可視性の範囲も指定します。
CheckAccess(IStorageItem)	最近使用した (MRU) リストの指定したストレージ項目にアプリがアクセスできるかどうかを判断します。
Clear()	最後に使用した (MRU) リストからすべてのストレージ項目を削除します。
ContainsItem(String)	最後に使用した (MRU) リストに指定されたストレージ項目が含まれているかどうかを判断します。
GetFileAsync(String)	最後に使用した (MRU) リストから、指定した storageFile を取得します。
GetFileAsync(String, AccessCacheOptions)	指定したオプションを使用して、最後に使用した (MRU) リストから指定された storageFile を取得します。
GetFolderAsync(String)	最後に使用した (MRU) リストから、指定した StorageFolder を取得します。
GetFolderAsync(String, AccessCacheOptions)	指定したオプションを使用して、最後に使用した (MRU) リストから指定した StorageFolder を取得します。
GetItemAsync(String)	最後に使用した (MRU) リストから、指定した項目 (ファイルやフォルダーなど) を取得します。
GetItemAsync(String, AccessCacheOptions)	指定したオプションを使用して、最後に使用した (MRU) リストから指定した項目 (ファイルやフォルダーなど) を取得します。
Remove(String)	最後に使用した (MRU) リストから、指定したストレージ項目を削除します。

イベント

ItemRemoved

ストレージ項目が最近使用した (MRU) リストから削除されると発生します。

適用対象

こちらもご覧ください

MostRecentlyUsedList