StorageItemMostRecentlyUsedList Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
- Penerapan
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). |