StoreContext 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 anggota yang dapat Anda gunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk aplikasi saat ini. Misalnya, Anda dapat menggunakan anggota kelas ini untuk mendapatkan daftar Microsoft Store dan info lisensi untuk aplikasi saat ini, membeli aplikasi atau produk saat ini yang ditawarkan oleh aplikasi, atau mengunduh dan menginstal pembaruan paket untuk aplikasi.
Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.
public ref class StoreContext sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Services.Store.StoreContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StoreContext final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Services.Store.StoreContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StoreContextPublic NotInheritable Class StoreContext- Warisan
- Atribut
Persyaratan Windows
| Rangkaian perangkat |
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
|
| API contract |
Windows.Services.Store.StoreContract (diperkenalkan dalam v1.0)
|
Keterangan
Catatan
Kelas ini dan namespace Windows.Services.Store lainnya diperkenalkan di Windows 10, versi 1607. Kelas ini hanya dapat digunakan dalam proyek yang menargetkan Windows 10 Anniversary Edition (10.0; Bangun 14393) atau rilis yang lebih baru di Visual Studio. Jika proyek Anda menargetkan versi Windows 10 yang lebih lama, Anda harus menggunakan namespace Windows.ApplicationModel.Store alih-alih namespace Windows.Services.Store. Untuk informasi selengkapnya, lihat Pembelian dan uji coba dalam aplikasi.
Kelas StoreContext adalah titik masuk utama ke namespace Windows.Services.Store . Gunakan anggota kelas ini untuk melakukan tugas seperti mendapatkan daftar Microsoft Store dan info lisensi untuk aplikasi saat ini, membeli aplikasi atau add-on saat ini yang ditawarkan oleh aplikasi, atau mengunduh dan menginstal pembaruan paket untuk aplikasi. Kelas dan jenis lain di namespace layanan ini mewakili item seperti add-on untuk aplikasi, lisensi untuk aplikasi dan add-onnya, dan info daftar Microsoft Store untuk aplikasi.
Untuk mendapatkan objek StoreContext, gunakan salah satu metode statis ini:
GetDefault: Gunakan metode ini di aplikasi pengguna tunggal (yaitu, aplikasi yang hanya berjalan dalam konteks pengguna yang meluncurkan aplikasi). Metode ini mendapatkan objek StoreContext yang dapat Anda gunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk pengguna. Sebagian besar aplikasi Platform Windows Universal (UWP) adalah aplikasi pengguna tunggal.
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();GetForUser: Gunakan metode ini di aplikasi multi-pengguna. Metode ini mendapatkan objek StoreContext yang dapat Anda gunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk pengguna tertentu. Untuk informasi selengkapnya tentang aplikasi multi-pengguna, lihat Pengantar aplikasi multi-pengguna.
var users = await Windows.System.User.FindAllAsync(); Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
Setelah memiliki objek StoreContext, Anda dapat mulai memanggil metode untuk membeli aplikasi atau add-on untuk pengguna saat ini dan tugas lainnya. Untuk informasi lebih lanjut, baca artikel berikut:
- Pembelian dan uji coba dalam aplikasi
- Mendapatkan info produk untuk aplikasi dan add-on
- Mendapatkan info lisensi untuk aplikasi dan add-on
- Mengaktifkan pembelian aplikasi dan add-on dalam aplikasi
- Mengaktifkan pembelian add-on yang dapat dikonsumsi
- Menerapkan versi uji coba aplikasi Anda
Anda juga dapat menggunakan objek StoreContext untuk mengunduh dan menginstal pembaruan paket untuk aplikasi. Untuk informasi selengkapnya, lihat Mengunduh dan menginstal pembaruan paket untuk aplikasi Anda.
Riwayat versi
| Versi Windows | Versi SDK | Nilai ditambahkan |
|---|---|---|
| 1703 | 15063 | FindStoreProductForPackageAsync |
| 1803 | 17134 | CanAcquireStoreLicenseAsync |
| 1803 | 17134 | CanAcquireStoreLicenseForOptionalPackageAsync |
| 1803 | 17134 | CanSilentlyDownloadStorePackageUpdates |
| 1803 | 17134 | DownloadAndInstallStorePackagesAsync |
| 1803 | 17134 | GetAssociatedStoreQueueItemsAsync |
| 1803 | 17134 | GetStoreProductsAsync(IEnumerable<String,IEnumerable<> String,StoreProductOptions>) |
| 1803 | 17134 | GetStoreQueueItemsAsync |
| 1803 | 17134 | RequestDownloadAndInstallStorePackagesAsync(IEnumerable<String,StorePackageInstallOptions>) |
| 1803 | 17134 | RequestUninstallStorePackageAsync |
| 1803 | 17134 | RequestUninstallStorePackageByStoreIdAsync |
| 1803 | 17134 | TrySilentDownloadAndInstallStorePackageUpdatesAsync |
| 1803 | 17134 | TrySilentDownloadStorePackageUpdatesAsync |
| 1803 | 17134 | UninstallStorePackageAsync |
| 1803 | 17134 | UninstallStorePackageByStoreIdAsync |
| 1809 | 17763 | RequestRateAndReviewAppAsync |
| 1809 | 17763 | SetInstallOrderForAssociatedStoreQueueItemsAsync |
Properti
| CanSilentlyDownloadStorePackageUpdates |
Mendapatkan nilai yang menunjukkan apakah pembaruan paket untuk aplikasi saat ini dapat diunduh tanpa menampilkan UI pemberitahuan kepada pengguna. |
| User |
Mendapatkan info tentang pengguna yang terkait dengan objek StoreContext saat ini di aplikasi multi-pengguna. |
Metode
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
Memperoleh lisensi untuk paket add-on konten yang dapat diunduh (DLC) yang ditentukan untuk aplikasi saat ini. |
| CanAcquireStoreLicenseAsync(String) |
Mendapatkan nilai yang menunjukkan apakah lisensi dapat diperoleh untuk add-on konten yang dapat diunduh (DLC) yang ditentukan dari aplikasi saat ini untuk pengguna saat ini. |
| CanAcquireStoreLicenseForOptionalPackageAsync(Package) |
Mendapatkan nilai yang menunjukkan apakah lisensi dapat diperoleh untuk paket konten yang dapat diunduh (DLC) yang ditentukan dari aplikasi saat ini untuk pengguna saat ini. |
| DownloadAndInstallStorePackagesAsync(IIterable<String>) |
Mengunduh dan menginstal paket konten yang dapat diunduh (DLC) yang ditentukan untuk aplikasi saat ini dari Microsoft Store tanpa menampilkan dialog antarmuka pengguna pemberitahuan kepada pengguna. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
Mendapatkan detail produk Store untuk aplikasi atau add-on yang terkait dengan paket yang ditentukan. |
| GetAppAndOptionalStorePackageUpdatesAsync() |
Mendapatkan koleksi paket untuk aplikasi saat ini yang memiliki pembaruan yang tersedia untuk diunduh dari Microsoft Store, termasuk paket opsional untuk aplikasi. |
| GetAppLicenseAsync() |
Mendapatkan info lisensi untuk aplikasi saat ini, termasuk lisensi untuk add-on untuk aplikasi saat ini. |
| GetAssociatedStoreProductsAsync(IIterable<String>) |
Mendapatkan info daftar Microsoft Store untuk produk yang dapat dibeli dari dalam aplikasi saat ini. |
| GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>) |
Menyediakan anggota yang dapat Anda gunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk aplikasi saat ini. Misalnya, Anda dapat menggunakan anggota kelas ini untuk mendapatkan daftar Microsoft Store dan info lisensi untuk aplikasi saat ini, membeli aplikasi atau produk saat ini yang ditawarkan oleh aplikasi, atau mengunduh dan menginstal pembaruan paket untuk aplikasi. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow. |
| GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32) |
Mendapatkan info daftar Microsoft Store untuk produk yang dapat dibeli dari dalam aplikasi saat ini. Metode ini mendukung halaman untuk mengembalikan hasilnya. |
| GetAssociatedStoreQueueItemsAsync() |
Mendapatkan info tentang semua paket baru atau yang diperbarui yang ada dalam antrean pengunduhan dan penginstalan untuk aplikasi saat ini. |
| GetConsumableBalanceRemainingAsync(String) |
Mendapatkan sisa saldo untuk add-on yang dapat dikonsumsi yang ditentukan untuk aplikasi saat ini. |
| GetCustomerCollectionsIdAsync(String, String) |
Mengambil kunci ID Microsoft Store yang dapat digunakan untuk mengkueri penetapan produk atau untuk mengonsumsi kepemilikan produk yang dimiliki oleh pengguna saat ini. |
| GetCustomerPurchaseIdAsync(String, String) |
Mengambil kunci ID Microsoft Store yang dapat digunakan untuk memberikan hak untuk produk gratis atas nama pengguna saat ini. |
| GetDefault() |
Mendapatkan objek StoreContext yang dapat digunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk pengguna saat ini dalam konteks aplikasi saat ini. |
| GetForUser(User) |
Mendapatkan objek StoreContext yang dapat digunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk pengguna yang ditentukan dalam konteks aplikasi saat ini. |
| GetStoreProductForCurrentAppAsync() |
Mendapatkan info daftar Microsoft Store untuk aplikasi saat ini dan menyediakan akses ke metode yang dapat Anda gunakan untuk membeli aplikasi untuk pengguna saat ini. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>) |
Mendapatkan info daftar Microsoft Store untuk produk tertentu yang terkait dengan aplikasi saat ini. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions) |
Mendapatkan info daftar Microsoft Store untuk produk tertentu yang terkait dengan aplikasi saat ini, dengan opsi untuk menggunakan filter untuk kueri. |
| GetStoreQueueItemsAsync(IIterable<String>) |
Mendapatkan info tentang paket baru atau yang diperbarui yang ditentukan yang ada dalam antrean pengunduhan dan penginstalan untuk aplikasi saat ini. |
| GetUserCollectionAsync(IIterable<String>) |
Mendapatkan info Microsoft Store untuk add-on aplikasi saat ini yang telah dibeli pengguna. |
| GetUserCollectionWithPagingAsync(IIterable<String>, UInt32) |
Mendapatkan info Microsoft Store untuk add-on aplikasi saat ini yang telah dibeli pengguna. Metode ini mendukung halaman untuk mengembalikan hasilnya. |
| GetUserPurchaseHistoryAsync(IIterable<String>) |
Menyediakan anggota yang dapat Anda gunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk aplikasi saat ini. Misalnya, Anda dapat menggunakan anggota kelas ini untuk mendapatkan daftar Microsoft Store dan info lisensi untuk aplikasi saat ini, membeli aplikasi atau produk saat ini yang ditawarkan oleh aplikasi, atau mengunduh dan menginstal pembaruan paket untuk aplikasi. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Melaporkan add-on yang dapat dikonsumsi untuk aplikasi saat ini seperti yang terpenuhi di Microsoft Store. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Mencoba mengunduh dan menginstal paket konten yang dapat diunduh (DLC) yang ditentukan untuk aplikasi saat ini dari Microsoft Store. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi. Penting Metode ini harus dipanggil pada utas UI. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Mencoba mengunduh dan menginstal paket konten yang dapat diunduh (DLC) yang ditentukan untuk aplikasi saat ini dari Microsoft Store, dengan opsi penginstalan yang ditentukan. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi. Penting Metode ini harus dipanggil pada utas UI. |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Mencoba mengunduh dan menginstal pembaruan paket yang ditentukan untuk aplikasi saat ini dari Microsoft Store. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi. Penting Metode ini harus dipanggil pada utas UI. |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Mencoba mengunduh pembaruan paket yang ditentukan untuk aplikasi saat ini dari Microsoft Store. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi. Penting Metode ini harus dipanggil pada utas UI. |
| RequestPurchaseAsync(String) |
Meminta pembelian untuk aplikasi atau add-on yang ditentukan dan menampilkan UI yang digunakan untuk menyelesaikan transaksi melalui Microsoft Store. Penting Metode ini harus dipanggil pada utas UI. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
Meminta pembelian untuk aplikasi atau add-on yang ditentukan dan menampilkan UI yang digunakan untuk menyelesaikan transaksi melalui Microsoft Store. Metode ini menyediakan opsi untuk menentukan detail tambahan untuk penawaran tertentu dalam katalog besar produk yang diwakili oleh satu daftar di Microsoft Store, termasuk nama produk untuk ditampilkan kepada pengguna selama pembelian. Penting Metode ini harus dipanggil pada utas UI. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Menyediakan anggota yang dapat Anda gunakan untuk mengakses dan mengelola data terkait Microsoft Store untuk aplikasi saat ini. Misalnya, Anda dapat menggunakan anggota kelas ini untuk mendapatkan daftar Microsoft Store dan info lisensi untuk aplikasi saat ini, membeli aplikasi atau produk saat ini yang ditawarkan oleh aplikasi, atau mengunduh dan menginstal pembaruan paket untuk aplikasi. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow. |
| RequestRateAndReviewAppAsync() |
Meminta pengguna untuk menilai dan meninjau aplikasi. Metode ini akan menampilkan UI bagi pengguna untuk memilih peringkat Toko dan menambahkan tinjauan Store opsional untuk produk. Penting Metode ini harus dipanggil pada utas UI. |
| RequestUninstallStorePackageAsync(Package) |
Mencoba menghapus instalan paket opsional yang ditentukan untuk aplikasi saat ini. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi. |
| RequestUninstallStorePackageByStoreIdAsync(String) |
Mencoba menghapus instalan paket konten yang dapat diunduh (DLC) yang ditentukan untuk aplikasi saat ini. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi. |
| SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>) |
Mengatur urutan untuk menginstal paket yang ditentukan dalam antrean pengunduhan dan penginstalan untuk aplikasi saat ini. |
| TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Mencoba mengunduh dan menginstal pembaruan paket yang ditentukan untuk aplikasi saat ini dari Microsoft Store tanpa menampilkan UI pemberitahuan kepada pengguna. |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Mencoba mengunduh pembaruan paket yang ditentukan untuk aplikasi saat ini dari Microsoft Store tanpa menampilkan UI pemberitahuan kepada pengguna. |
| UninstallStorePackageAsync(Package) |
Menghapus instalan paket opsional yang ditentukan untuk aplikasi saat ini tanpa menampilkan dialog antarmuka pengguna pemberitahuan kepada pengguna. |
| UninstallStorePackageByStoreIdAsync(String) |
Menghapus instalan paket konten yang dapat diunduh (DLC) yang ditentukan untuk aplikasi saat ini tanpa menampilkan dialog UI pemberitahuan kepada pengguna. |
Acara
| OfflineLicensesChanged |
Dinaikkan saat status lisensi aplikasi berubah (misalnya, periode uji coba telah kedaluwarsa atau pengguna telah membeli versi lengkap aplikasi). |
Berlaku untuk
Lihat juga
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk