StorageItemAccessList クラス

リファレンス

定義

名前空間:: Windows.Storage.AccessCache

重要

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

編集

アプリの future-access リスト (静的 StorageApplicationPermissions.FutureAccessList プロパティから取得) を表します。ファイルやフォルダーを選ぶことで、ユーザーはアプリがアクセスできない可能性がある項目にアクセス許可を付与します。これらの項目を後でアクセスする一覧に追加すると、後にそれらの項目にアプリがアクセスする場合に備えてアクセス許可が保持されます。アイテムは、将来のアクセスリストに StorageFile オブジェクトと StorageFolder オブジェクトとして格納されます。

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

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

注釈

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

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

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

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

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

プロパティ

Entries	アクセスリストからストレージ項目を取得するためのオブジェクトを取得します。
MaximumItemsAllowed	アクセスリストに含めることができるストレージ項目の最大数を取得します。

メソッド

Add(IStorageItem)	新しいストレージ項目をアクセスリストに追加します。
Add(IStorageItem, String)	新しいストレージ項目と付随するメタデータをアクセスリストに追加します。
AddOrReplace(String, IStorageItem)	新しいストレージ項目をアクセスリストに追加するか、指定した項目がリストに既に存在する場合は置き換えます。
AddOrReplace(String, IStorageItem, String)	新しいストレージ項目と付随するメタデータをアクセスリストに追加するか、指定した項目がリストに既に存在する場合は置き換えます。
CheckAccess(IStorageItem)	アプリがアクセスリスト内の指定されたストレージ項目にアクセスできるかどうかを判断します。
Clear()	アクセスリストからすべてのストレージ項目を削除します。
ContainsItem(String)	アクセスリストに指定されたストレージ項目が含まれているかどうかを判断します。
GetFileAsync(String)	指定した StorageFile を一覧から取得します。
GetFileAsync(String, AccessCacheOptions)	指定したオプションを使用して、一覧から StorageFile を取得します。
GetFolderAsync(String)	指定した StorageFolder を一覧から取得します。
GetFolderAsync(String, AccessCacheOptions)	指定したオプションを使用して、指定した StorageFolder を一覧から取得します。
GetItemAsync(String)	最後に使用した (MRU) リストから、指定した項目 (ファイルやフォルダーなど) を取得します。
GetItemAsync(String, AccessCacheOptions)	指定したオプションを使用して、指定した項目 (ファイルやフォルダーなど) をリストから取得します。
Remove(String)	指定したストレージ項目をアクセスリストから削除します。

適用対象

こちらもご覧ください

FutureAccessList

次の方法で共有