StorageApplicationPermissions Kelas

Definisi

Ruang nama:

Windows.Storage.AccessCache

Menyediakan properti statis bagi Anda untuk mendapatkan daftar aplikasi yang terakhir digunakan (MRU) (gunakan StorageApplicationPermissions.MostRecentlyUsedList) dan daftar akses mendatang (gunakan 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

Warisan

Object Platform::Object IInspectable StorageApplicationPermissions

Atribut

ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh ini menunjukkan cara menambahkan item ke FutureAccessList dan MostRecentlyUsedList aplikasi.

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
    }
}

Disarankan agar Anda menyimpan token yang dikembalikan oleh StorageApplicationPermissions.MostRecentlyUsedList.Add dan StorageApplicationPermissions.FutureAccessList.Add sehingga Anda dapat menggunakannya untuk mengambil entri daftar masing-masing untuk item yang Anda tambahkan. Dalam contoh, kami menyimpan token di mruToken dan faToken masing-masing tetapi kami tidak melakukan hal lain dengan token tersebut.

Selain itu, savePicker variabel dalam contoh berisi objek FileSavePicker yang dibuat oleh sampel. Untuk mempelajari selengkapnya tentang menyimpan file dengan pemilih file, lihat Menyimpan file dengan pemilih. Untuk mempelajari tentang mengakses file, lihat Membuka file dan folder dengan pemilih.

Keterangan

Akses metode dan properti kelas ini secara statis.

Untuk melihat contoh kode lainnya, lihat sampel Pemilih file dan sampel Akses file.

Untuk mempelajari tentang menggunakan FutureAccessList dan MostRecentlyUsedList, lihat Melacak file dan folder yang baru digunakan.

Untuk mempelajari tentang file dan lokasi apa yang memiliki izin untuk diakses aplikasi Anda, lihat Izin akses file.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Properti

FutureAccessList	Mendapatkan objek yang mewakili daftar yang dikelola aplikasi sehingga aplikasi dapat menyimpan file dan/atau lokasi (seperti folder) dan dengan mudah mengakses item ini di masa mendatang.
MostRecentlyUsedList	Mendapatkan objek yang mewakili daftar yang dapat digunakan aplikasi untuk melacak file dan/atau lokasi (seperti folder) yang telah diakses aplikasi baru-baru ini.

Metode

GetFutureAccessListForUser(User)	Mendapatkan objek yang mewakili daftar yang dikelola aplikasi sehingga aplikasi dapat menyimpan file dan/atau lokasi (seperti folder) dan dengan mudah mengakses item ini di masa mendatang. Metode ini mengembalikan objek yang dilingkup ke pengguna yang ditentukan. Gunakan metode ini untuk aplikasi multi-pengguna.
GetMostRecentlyUsedListForUser(User)	Mendapatkan objek yang dapat digunakan aplikasi untuk melacak file dan/atau lokasi (seperti folder) yang telah diakses aplikasi baru-baru ini. Metode ini mengembalikan objek yang dilingkup ke pengguna yang ditentukan. Gunakan metode ini untuk aplikasi multi-pengguna.