StorageItemAccessList クラス

定義

public ref class StorageItemAccessList sealed : IStorageItemAccessList

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemAccessList final : IStorageItemAccessList

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemAccessList : IStorageItemAccessList

Public NotInheritable Class StorageItemAccessList
Implements IStorageItemAccessList

継承

Object Platform::Object IInspectable StorageItemAccessList

属性

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 オブジェクトが含まれています。 ファイル ピッカーの使用方法の詳細については、「ピッカーで ファイルとフォルダーを開く」および「ピッカーを 使用 してファイルを保存する」を参照してください。

注釈

この将来のアクセスリストを使用して、アプリ マニフェストの機能で指定されたアクセス可能な場所に含まれていない可能性があるファイルや場所へのアクセスを保持します。 たとえば、アプリでファイル ピッカーを使用してファイル (または場所) にアクセスする場合は、ファイル ピッカーから返される StorageFile を、今後のアクセスリストに格納することをお勧めします。

この一覧には最大 1,000 個の項目を格納でき、アプリで管理する必要があります。

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

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

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

プロパティ

メソッド

適用対象

こちらもご覧ください

• FutureAccessList