StorageItemAccessList Kelas

Definisi

Ruang nama:

Windows.Storage.AccessCache

Mewakili daftar akses aplikasi Anda di masa mendatang (diperoleh dari properti Static StorageApplicationPermissions.FutureAccessList ). Dengan memilih file dan folder, pengguna Anda memberikan izin aplikasi untuk mengakses item yang mungkin tidak dapat diakses sebaliknya. Jika Anda menambahkan item ini ke daftar akses mendatang, maka Anda akan mempertahankan izin tersebut saat aplikasi ingin mengakses item tersebut lagi nanti. Item disimpan dalam daftar akses di masa mendatang sebagai objek StorageFile dan 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

Warisan

Object Platform::Object IInspectable StorageItemAccessList

Atribut

ContractVersionAttribute

Penerapan

IStorageItemAccessList

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

Kami menyarankan 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 menggunakan pemilih file, lihat Membuka file dan folder dengan pemilih dan Menyimpan file dengan pemilih.

Keterangan

Gunakan daftar akses di masa mendatang ini untuk mempertahankan akses ke file dan lokasi yang mungkin tidak disertakan dengan lokasi yang dapat diakses yang ditentukan oleh kemampuan dalam manifes aplikasi Anda. Misalnya, jika aplikasi Anda menggunakan pemilih file untuk mengakses file (atau lokasi), kami sarankan Anda menyimpan StorageFile yang dikembalikan dari pemilih file dalam daftar akses mendatang ini.

Daftar ini dapat menyimpan hingga 1000 item dan harus dipertahankan oleh aplikasi.

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 selengkapnya tentang file dan lokasi apa yang izinnya diakses aplikasi Anda, lihat Izin akses file.

Properti

Entries	Mendapatkan objek untuk mengambil item penyimpanan dari daftar akses.
MaximumItemsAllowed	Mendapatkan jumlah maksimum item penyimpanan yang dapat dimuat oleh daftar akses.

Metode

Add(IStorageItem)	Menambahkan item penyimpanan baru ke daftar akses.
Add(IStorageItem, String)	Menambahkan item penyimpanan baru dan metadata yang menyertainya ke daftar akses.
AddOrReplace(String, IStorageItem)	Menambahkan item penyimpanan baru ke daftar akses, atau mengganti item yang ditentukan jika sudah ada dalam daftar.
AddOrReplace(String, IStorageItem, String)	Menambahkan item penyimpanan baru dan metadata yang menyertainya ke daftar akses, atau mengganti item yang ditentukan jika sudah ada dalam daftar.
CheckAccess(IStorageItem)	Menentukan apakah aplikasi memiliki akses ke item penyimpanan yang ditentukan dalam daftar akses.
Clear()	Menghapus semua item penyimpanan dari daftar akses.
ContainsItem(String)	Menentukan apakah daftar akses berisi item penyimpanan yang ditentukan.
GetFileAsync(String)	Mengambil StorageFile yang ditentukan dari daftar.
GetFileAsync(String, AccessCacheOptions)	Mengambil StorageFile dari daftar menggunakan opsi yang ditentukan.
GetFolderAsync(String)	Mengambil StorageFolder yang ditentukan dari daftar.
GetFolderAsync(String, AccessCacheOptions)	Mengambil StorageFolder yang ditentukan dari daftar menggunakan opsi yang ditentukan.
GetItemAsync(String)	Mengambil item yang ditentukan (seperti file atau folder) dari daftar yang terakhir digunakan (MRU).
GetItemAsync(String, AccessCacheOptions)	Mengambil item yang ditentukan (seperti file atau folder) dari daftar menggunakan opsi yang ditentukan.
Remove(String)	Menghapus item penyimpanan yang ditentukan dari daftar akses.

Lihat juga

• FutureAccessList