StorageApplicationPermissions 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.
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
- Atribut
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. |