StorageItemMostRecentlyUsedList 類別

定義

命名空間:

Windows.Storage.AccessCache

代表從靜態 StorageApplicationPermissions.MostRecentlyUsedList 屬性) 取得 (MRU) (的最新使用清單。 您可以使用 MRU 來追蹤使用者最近存取 (檔案和/或資料夾) 的專案。 專案會以 StorageFile 和 StorageFolder 物件的形式儲存在 MRU 中。

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