StorageApplicationPermissions クラス

定義

アプリの最近使用したリスト (MRU) ( StorageApplicationPermissions.MostRecentlyUsedList を使用) と future-access list ( StorageApplicationPermissions.FutureAccessList を使用) を取得するための静的プロパティを提供します。

public ref class StorageApplicationPermissions abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageApplicationPermissions final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class StorageApplicationPermissions
Public Class StorageApplicationPermissions
継承
Object Platform::Object IInspectable StorageApplicationPermissions
属性

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

注釈

このクラスのメソッドとプロパティに静的にアクセスします。

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

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

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

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1903 18362 GetFutureAccessListForUser
1903 18362 GetMostRecentlyUsedListForUser

プロパティ

FutureAccessList

アプリがファイルや場所 (フォルダーなど) を格納し、将来これらの項目に簡単にアクセスできるように、アプリが保持するリストを表す オブジェクトを取得します。

MostRecentlyUsedList

アプリが最近アクセスしたファイルや場所 (フォルダーなど) を追跡するためにアプリが使用できるリストを表す オブジェクトを取得します。

メソッド

GetFutureAccessListForUser(User)

アプリがファイルや場所 (フォルダーなど) を格納し、将来これらの項目に簡単にアクセスできるように、アプリが保持するリストを表す オブジェクトを取得します。 このメソッドは、指定したユーザーをスコープとするオブジェクトを返します。 このメソッドは 、マルチユーザー アプリケーションに使用します

GetMostRecentlyUsedListForUser(User)

アプリが最近アクセスしたファイルや場所 (フォルダーなど) を追跡するためにアプリが使用できるオブジェクトを取得します。 このメソッドは、指定したユーザーをスコープとするオブジェクトを返します。 このメソッドは 、マルチユーザー アプリケーションに使用します

適用対象