StorageApplicationPermissions 類別

定義

命名空間:

Windows.Storage.AccessCache

提供靜態屬性，讓您取得應用程式最近使用的清單 (MRU) (使用 StorageApplicationPermissions.MostRecentlyUsedList) 和未來存取清單， (使用 StorageApplicationPermissions.FutureAccessList。

public ref class StorageApplicationPermissions abstract sealed

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

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class StorageApplicationPermissions

Public Class StorageApplicationPermissions

繼承

Object Platform::Object IInspectable StorageApplicationPermissions

屬性

ContractVersionAttribute

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 所傳回的權杖，讓您可以使用它們來擷取您所新增專案的個別清單專案。 在此範例中，我們會分別將權杖儲存在 mruToken 和 faToken 中，但不會使用它們執行任何其他動作。

此外， savePicker 此範例中的 變數包含範例所建立的 FileSavePicker 物件。 若要深入瞭解如何使用檔案選擇器儲存檔案，請參閱 使用選擇器儲存檔案。 若要瞭解如何存取檔案，請參閱 使用選擇器開啟檔案和資料夾。

備註

以靜態方式存取這個類別的方法和屬性。

若要查看更多程式碼範例，請參閱 檔案選擇器範例 和 檔案存取範例。

若要瞭解如何使用 FutureAccessList 和 MostRecentlyUsedList，請參閱 追蹤最近使用的檔案和資料夾。

若要瞭解您的應用程式有權存取的檔案和位置，請參閱 檔案存取權限。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

屬性

FutureAccessList	取得 物件，代表應用程式維護的清單，讓應用程式可以儲存檔案和/或位置 (，例如資料夾) ，並在未來輕鬆存取這些專案。
MostRecentlyUsedList	取得 物件，表示應用程式可用來追蹤檔案和/或位置的清單，例如應用程式最近存取的資料夾) 等檔案和/或 (位置。

方法

GetFutureAccessListForUser(User)	取得 物件，代表應用程式維護的清單，讓應用程式可以儲存檔案和/或位置 (，例如資料夾) ，並在未來輕鬆存取這些專案。 這個方法會傳回範圍設定為指定使用者的物件。 針對 多使用者應用程式使用這個方法。
GetMostRecentlyUsedListForUser(User)	取得應用程式可用來追蹤檔案和/或位置 (的物件，例如應用程式最近存取的資料夾) 。 這個方法會傳回範圍設定為指定使用者的物件。 針對 多使用者應用程式使用這個方法。