ApplicationData.GetPublisherCacheFolder(String) Metode

Definisi

Ruang nama:

Windows.Storage

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

StorageFolder

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.

Lihat juga

• ClearPublisherCacheFolderAsync(String)