다음을 통해 공유


StorageItemAccessList 클래스

정의

앱의 미래 액세스 목록(정적 StorageApplicationPermissions.FutureAccessList 속성에서 가져온)을 나타냅니다. 파일 및 폴더를 선택하여 사용자는 액세스하지 못할 수 있는 항목에 대한 액세스 권한을 앱에 부여할 수 있습니다. 이러한 항목을 향후 액세스 목록에 추가하면 나중에서 앱이 이러한 항목에 다시 액세스하려는 경우 해당 권한이 유지됩니다. 항목은 이후 액세스 목록에 StorageFileStorageFolder 개체로 저장됩니다.

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
특성
구현

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.AddStorageApplicationPermissions.FutureAccessList.Add에서 반환되는 토큰을 저장하여 추가한 항목에 대한 해당 목록 항목을 검색하는 데 사용할 수 있도록 하는 것이 좋습니다. 이 예제에서는 토큰을 각각 및 faTokenmruToken 저장하지만 다른 작업은 수행하지 않습니다.

또한 예제의 savePicker 변수에는 샘플에서 만든 FileSavePicker 개체가 포함됩니다. 파일 선택기를 사용하는 방법에 대한 자세한 내용은 선택기로 파일 및 폴더 열기 및 선택 기로 파일 저장을 참조하세요.

설명

이 미래 액세스 목록을 사용하여 앱 매니페스트의 기능으로 지정된 액세스 가능한 위치에 포함되지 않을 수 있는 파일 및 위치에 대한 액세스를 유지합니다. 예를 들어 앱에서 파일 선택기를 사용하여 파일(또는 위치)에 액세스하는 경우 이 이후 액세스 목록에 파일 선택기에서 반환된 StorageFile 을 저장하는 것이 좋습니다.

이 목록은 최대 1000개 항목을 저장할 수 있으며 앱에서 유지 관리해야 합니다.

더 많은 코드 예제를 보려면 파일 선택기 샘플파일 액세스 샘플을 참조하세요.

FutureAccessListMostRecentlyUsedList를 사용하는 방법에 대한 자세한 내용은 최근에 사용한 파일 및 폴더 추적을 참조하세요.

앱에 액세스할 수 있는 권한이 있는 파일 및 위치에 대한 자세한 내용은 파일 액세스 권한을 참조하세요.

속성

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)

액세스 목록에서 지정된 스토리지 항목을 제거합니다.

적용 대상

추가 정보