StorageApplicationPermissions クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
- 継承
- 属性
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 によって返されるトークンを格納して、追加したアイテムのそれぞれのリスト エントリを取得できるようにすることをお勧めします。 この例では、トークンをそれぞれ にmruToken
faToken
格納しますが、他の処理は行いません。
さらに、この例の savePicker
変数には、サンプルによって作成された FileSavePicker オブジェクトが含まれています。 ファイル ピッカーを使用してファイルを保存する方法の詳細については、「ピッカーを使用して ファイルを保存する」を参照してください。 ファイルへのアクセスの詳細については、「ピッカーを使用して ファイルとフォルダーを開く」を参照してください。
注釈
このクラスのメソッドとプロパティに静的にアクセスします。
その他のコード例については、 ファイル ピッカーのサンプル と ファイル アクセスのサンプルに関するページを参照してください。
FutureAccessList と MostRecentlyUsedList の使用については、「最近使用したファイルとフォルダーを追跡する」を参照してください。
アプリがアクセス許可を持つファイルと場所については、「 ファイル アクセス許可」を参照してください。
バージョン履歴
Windows のバージョン | SDK バージョン | 追加された値 |
---|---|---|
1903 | 18362 | GetFutureAccessListForUser |
1903 | 18362 | GetMostRecentlyUsedListForUser |
プロパティ
FutureAccessList |
アプリがファイルや場所 (フォルダーなど) を格納し、将来これらの項目に簡単にアクセスできるように、アプリが保持するリストを表す オブジェクトを取得します。 |
MostRecentlyUsedList |
アプリが最近アクセスしたファイルや場所 (フォルダーなど) を追跡するためにアプリが使用できるリストを表す オブジェクトを取得します。 |
メソッド
GetFutureAccessListForUser(User) |
アプリがファイルや場所 (フォルダーなど) を格納し、将来これらの項目に簡単にアクセスできるように、アプリが保持するリストを表す オブジェクトを取得します。 このメソッドは、指定したユーザーをスコープとするオブジェクトを返します。 このメソッドは 、マルチユーザー アプリケーションに使用します。 |
GetMostRecentlyUsedListForUser(User) |
アプリが最近アクセスしたファイルや場所 (フォルダーなど) を追跡するためにアプリが使用できるオブジェクトを取得します。 このメソッドは、指定したユーザーをスコープとするオブジェクトを返します。 このメソッドは 、マルチユーザー アプリケーションに使用します。 |