StorageItemMostRecentlyUsedList Kelas

Definisi

Ruang nama:

Windows.Storage.AccessCache

Mewakili daftar aplikasi Anda yang terakhir digunakan (MRU) (diperoleh dari properti StorageApplicationPermissions.MostRecentlyUsedList statis). Anda menggunakan MRU untuk melacak item (file dan/atau folder) yang telah diakses pengguna baru-baru ini. Item disimpan di MRU sebagai objek StorageFile dan 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

Warisan

Object Platform::Object IInspectable StorageItemMostRecentlyUsedList

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 menyimpan file dengan pemilih file, lihat Menyimpan file dengan pemilih. Untuk mempelajari tentang mengakses file, lihat Membuka file dan folder dengan pemilih.

Keterangan

Gunakan daftar yang terakhir digunakan (MRU) untuk melacak file dan/atau lokasi yang sering diakses pengguna Anda.

Daftar ini dapat menyimpan hingga 25 item. Meskipun aplikasi harus menambahkan item ke MRU untuk melacaknya, Windows mempertahankan batas 25 item dengan menghapus item kedaluarsa jika perlu.

Catatan

Jika Anda ingin menanggapi peristiwa ItemRemoved , Anda harus mendaftarkan penanganan aktivitas Anda setiap kali Anda mendapatkan referensi baru ke StorageItemMostRecentlyUsedList.

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 yang terakhir digunakan (MRU).
MaximumItemsAllowed	Mendapatkan jumlah maksimum item penyimpanan yang dapat dimuat oleh daftar yang terakhir digunakan (MRU).

Metode

Add(IStorageItem)	Menambahkan item penyimpanan baru ke daftar yang terakhir digunakan (MRU).
Add(IStorageItem, String)	Menambahkan item penyimpanan baru dan metadata yang menyertainya ke daftar yang terakhir digunakan (MRU).
Add(IStorageItem, String, RecentStorageItemVisibility)	Menambahkan item penyimpanan baru dan metadata yang menyertainya ke daftar yang terakhir digunakan (MRU), menentukan sejauh mana visibilitasnya dalam daftar.
AddOrReplace(String, IStorageItem)	Menambahkan item penyimpanan baru ke daftar yang terakhir digunakan (MRU), atau mengganti item yang ditentukan jika sudah ada dalam daftar.
AddOrReplace(String, IStorageItem, String)	Menambahkan item penyimpanan baru dan metadata yang menyertainya ke daftar yang terakhir digunakan (MRU), atau mengganti item yang ditentukan jika sudah ada dalam daftar.
AddOrReplace(String, IStorageItem, String, RecentStorageItemVisibility)	Menambahkan item penyimpanan baru dan metadata yang menyertainya ke daftar yang terakhir digunakan (MRU), atau mengganti item yang ditentukan jika sudah ada dalam daftar. Juga menentukan sejauh mana visibilitasnya dalam daftar.
CheckAccess(IStorageItem)	Menentukan apakah aplikasi memiliki akses ke item penyimpanan yang ditentukan dalam daftar yang terakhir digunakan (MRU).
Clear()	Menghapus semua item penyimpanan dari daftar yang terakhir digunakan (MRU).
ContainsItem(String)	Menentukan apakah daftar yang terakhir digunakan (MRU) berisi item penyimpanan yang ditentukan.
GetFileAsync(String)	Mengambil storageFile yang ditentukan dari daftar yang terakhir digunakan (MRU).
GetFileAsync(String, AccessCacheOptions)	Mengambil storageFile yang ditentukan dari daftar yang terakhir digunakan (MRU) menggunakan opsi yang ditentukan.
GetFolderAsync(String)	Mengambil StorageFolder yang ditentukan dari daftar yang terakhir digunakan (MRU).
GetFolderAsync(String, AccessCacheOptions)	Mengambil StorageFolder yang ditentukan dari daftar yang terakhir digunakan (MRU) 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 yang terakhir digunakan (MRU) menggunakan opsi yang ditentukan.
Remove(String)	Menghapus item penyimpanan yang ditentukan dari daftar yang terakhir digunakan (MRU).

Acara

ItemRemoved

Diaktifkan saat item penyimpanan dihapus dari daftar yang terakhir digunakan (MRU).

Lihat juga

• MostRecentlyUsedList