StorageItemAccessList 클래스

정의

네임스페이스:

Windows.Storage.AccessCache

앱의 미래 액세스 목록(정적 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에서 반환되는 토큰을 저장하여 추가한 항목에 대한 해당 목록 항목을 검색하는 데 사용할 수 있도록 하는 것이 좋습니다. 이 예제에서는 토큰을 각각 및 faToken 에 mruToken 저장하지만 다른 작업은 수행하지 않습니다.

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

설명

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

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

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

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