次の方法で共有


StorageItemMostRecentlyUsedList クラス

定義

アプリの最近使用したリスト (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
属性
実装

Windows の要件

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

この例では、アプリの FutureAccessListMostRecentlyUsedList に項目を追加する方法を示します。

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 への新しい参照を取得するたびに、イベント ハンドラーを登録する必要があります。

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

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

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

プロパティ

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) リストから削除されると発生します。

適用対象

こちらもご覧ください