StorageItemMostRecentlyUsedList クラス

定義

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 の要件

例

この例では、アプリの 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 項目の制限を維持します。

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

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

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

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• MostRecentlyUsedList