StorageApplicationPermissions クラス

リファレンス

定義

名前空間:: Windows.Storage.AccessCache

重要

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

編集

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

属性: ContractVersionAttribute

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

注釈

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

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

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

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

バージョン履歴

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

プロパティ

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

メソッド

GetFutureAccessListForUser(User)

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

GetMostRecentlyUsedListForUser(User)

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

適用対象