StorageItemMostRecentlyUsedList 클래스

정의

네임스페이스:

Windows.Storage.AccessCache

앱의 가장 최근에 사용한 목록(MRU)을 나타냅니다(정적 StorageApplicationPermissions.MostRecentlyUsedList 속성에서 가져온). MRU를 사용하여 사용자가 가장 최근에 액세스한 항목(파일 및/또는 폴더)을 추적합니다. 항목은 MRU에 StorageFile 및 StorageFolder 개체로 저장됩니다.

public ref class StorageItemMostRecentlyUsedList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemMostRecentlyUsedList final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemMostRecentlyUsedList

Public NotInheritable Class StorageItemMostRecentlyUsedList

상속

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

특성

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 개체가 포함됩니다. 파일 선택기를 사용하여 파일을 저장하는 방법에 대한 자세한 내용은 선택기로 파일 저장을 참조하세요. 파일에 액세스하는 방법에 대한 자세한 내용은 선택기를 사용하여 파일 및 폴더 열기를 참조하세요.

설명

가장 최근에 사용한(MRU) 목록을 사용하여 사용자가 자주 액세스하는 파일 및/또는 위치를 추적합니다.

이 목록은 최대 25개 항목을 저장할 수 있습니다. 앱이 항목을 추적하기 위해 MRU에 항목을 추가해야 하지만 필요한 경우 오래된 항목을 제거하여 Windows에서 25개 항목 제한을 유지합니다.

참고

ItemRemoved 이벤트에 응답하려면 StorageItemMostRecentlyUsedList에 대한 새 참조를 가져올 때마다 이벤트 처리기를 등록해야 합니다.

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

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

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

속성

Entries	가장 최근에 사용한(MRU) 목록에서 스토리지 항목을 검색하기 위한 개체를 가져옵니다.
MaximumItemsAllowed	가장 최근에 사용한(MRU) 목록에 포함될 수 있는 스토리지 항목의 최대 수를 가져옵니다.

메서드

Add(IStorageItem)	MRU(가장 최근에 사용한) 목록에 새 스토리지 항목을 추가합니다.
Add(IStorageItem, String)	MRU(가장 최근에 사용한) 목록에 새 스토리지 항목과 함께 제공되는 메타데이터를 추가합니다.
Add(IStorageItem, String, RecentStorageItemVisibility)	새 스토리지 항목과 함께 제공되는 메타데이터를 가장 최근에 사용한(MRU) 목록에 추가하여 목록에서 표시 범위를 지정합니다.
AddOrReplace(String, IStorageItem)	가장 최근에 사용한(MRU) 목록에 새 스토리지 항목을 추가하거나 목록에 이미 있는 경우 지정된 항목을 바꿉니다.
AddOrReplace(String, IStorageItem, String)	새 스토리지 항목과 함께 제공되는 메타데이터를 가장 최근에 사용한(MRU) 목록에 추가하거나 목록에 이미 있는 경우 지정된 항목을 바꿉니다.
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	새 스토리지 항목과 함께 제공되는 메타데이터를 가장 최근에 사용한(MRU) 목록에 추가하거나 목록에 이미 있는 경우 지정된 항목을 바꿉니다. 또한 목록에서 표시 범위도 지정합니다.
CheckAccess(IStorageItem)	앱이 가장 최근에 사용한(MRU) 목록에서 지정된 스토리지 항목에 액세스할 수 있는지 여부를 결정합니다.
Clear()	가장 최근에 사용한(MRU) 목록에서 모든 스토리지 항목을 제거합니다.
ContainsItem(String)	가장 최근에 사용한(MRU) 목록에 지정된 스토리지 항목이 포함되어 있는지 여부를 확인합니다.
GetFileAsync(String)	가장 최근에 사용한(MRU) 목록에서 지정된 storageFile 을 검색합니다.
GetFileAsync(String, AccessCacheOptions)	지정된 옵션을 사용하여 가장 최근에 사용한(MRU) 목록에서 지정된 storageFile 을 검색합니다.
GetFolderAsync(String)	가장 최근에 사용한(MRU) 목록에서 지정된 StorageFolder 를 검색합니다.
GetFolderAsync(String, AccessCacheOptions)	지정된 옵션을 사용하여 가장 최근에 사용한(MRU) 목록에서 지정된 StorageFolder 를 검색합니다.
GetItemAsync(String)	가장 최근에 사용한(MRU) 목록에서 지정된 항목(예: 파일 또는 폴더)을 검색합니다.
GetItemAsync(String, AccessCacheOptions)	지정된 옵션을 사용하여 가장 최근에 사용한(MRU) 목록에서 지정된 항목(예: 파일 또는 폴더)을 검색합니다.
Remove(String)	가장 최근에 사용한(MRU) 목록에서 지정된 스토리지 항목을 제거합니다.

이벤트

ItemRemoved

가장 최근에 사용한(MRU) 목록에서 스토리지 항목이 제거되면 발생합니다.

추가 정보

• MostRecentlyUsedList