ApplicationData.GetPublisherCacheFolder(String) Metode
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.
Mendapatkan subfolder folder penyimpanan bersama yang ditentukan untuk penerbit aplikasi saat ini.
public:
virtual StorageFolder ^ GetPublisherCacheFolder(Platform::String ^ folderName) = GetPublisherCacheFolder;
StorageFolder GetPublisherCacheFolder(winrt::hstring const& folderName);
public StorageFolder GetPublisherCacheFolder(string folderName);
function getPublisherCacheFolder(folderName)
Public Function GetPublisherCacheFolder (folderName As String) As StorageFolder
Parameter
- folderName
-
String
Platform::String
winrt::hstring
Subfolder yang akan didapatkan dari folder penyimpanan bersama untuk penerbit aplikasi saat ini.
Mengembalikan
Subfolder yang ditentukan.
Keterangan
Model keamanan aplikasi Windows Runtime yang kuat biasanya mencegah aplikasi berbagi data di antara mereka sendiri. Namun, ini dapat berguna untuk aplikasi dari penerbit yang sama untuk berbagi file dan pengaturan berdasarkan per pengguna. Sebagai penerbit aplikasi, Anda dapat mendaftarkan aplikasi untuk berbagi folder penyimpanan dengan aplikasi lain yang Anda terbitkan dengan menambahkan ekstensi ke manifes aplikasi.
Berikut adalah beberapa contoh bagaimana Anda dapat menggunakan folder penyimpanan bersama ini jika Anda menerbitkan beberapa aplikasi.
- Berbagi file. Misalnya, jika beberapa aplikasi menggunakan gambar yang sama atau font kustom yang sama, Anda dapat menyimpan file-file ini di folder penyimpanan bersama.
- Bagikan pengaturan pengguna dalam file pengaturan kustom. Misalnya, jika beberapa aplikasi menggunakan suhu, Anda dapat menyimpan salinan preferensi pengguna untuk Celcius atau Fahrenheit dalam file pengaturan kustom di folder penyimpanan bersama. Kami menyarankan agar Anda juga menyimpan pengaturan pengguna dengan setiap aplikasi atau di lokasi master lain, karena pengguna dapat menghapus konten folder penyimpanan bersama. Folder penyimpanan bersama untuk penerbit aplikasi secara otomatis disediakan saat pengguna menginstal aplikasi pertama dari penerbit.
Folder penyimpanan bersama memiliki persyaratan dan batasan berikut.
- Data di folder penyimpanan bersama tidak dicadangkan atau dijelajahi. Selain itu, pengguna dapat menghapus konten folder penyimpanan bersama.
- Anda tidak dapat menggunakan fitur ini untuk berbagi data di antara aplikasi dari penerbit yang berbeda.
- Anda tidak dapat menggunakan fitur ini untuk berbagi data di antara pengguna yang berbeda.
- Folder penyimpanan bersama tidak memiliki manajemen versi.
Untuk mendaftarkan aplikasi untuk menggunakan folder penyimpanan bersama penerbit
Masukkan XML secara manual yang mirip dengan contoh berikut dalam manifes aplikasi untuk mendaftarkan subfolder. Anda tidak perlu membuat subfolder ini. Mereka secara otomatis disediakan untuk Anda.
<Package>
…
<Extensions>
…
<Extension Category="windows.publisherCacheFolders">
<PublisherCacheFolders>
<Folder Name="Folder1"/>
<Folder Name="Folder2"/>
</PublisherCacheFolders>
</Extension>
…
</Extensions>
…
</Package>
Untuk mengakses data di folder penyimpanan bersama penerbit
Panggil metode GetPublisherCacheFolder untuk mendapatkan salah satu subfolder terdaftar dari folder penyimpanan bersama.
Kemudian gunakan properti dan metode kelas StorageFolder untuk membaca dan menulis file dan subfolder di folder bersama.
Akses ke folder penyimpanan bersama memiliki persyaratan dan batasan berikut.
- Tidak ada subfolder default. Anda harus menentukan subfolder saat memanggil metode GetPublisherCacheFolder.
- Anda hanya dapat mengakses subfolder yang terdaftar dalam manifes aplikasi.
- Anda tidak dapat mengakses akar folder penyimpanan bersama.
Untuk membersihkan data di folder penyimpanan bersama penerbit
Panggil metode ClearPublisherCacheFolderAsync untuk menghapus file dan subfolder dari subfolder folder penyimpanan bersama yang ditentukan untuk penerbit aplikasi saat ini.
Folder penyimpanan bersama secara otomatis dibersihkan saat aplikasi terakhir dari penerbit dihapus instalannya.
Data yang disimpan di folder penyimpanan bersama tidak ditautkan ke aplikasi yang menyimpannya. Saat Anda menghapus instalan aplikasi yang menyimpan data, data tetap berada di folder penyimpanan bersama hingga aplikasi terakhir dari penerbit yang sama dihapus instalannya.
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk