StoreContext.RequestDownloadAndInstallStorePackagesAsync 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.
Overload
| 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. |
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.
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);function requestDownloadAndInstallStorePackagesAsync(storeIds)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parameter
ID Penyimpanan paket add-on DLC untuk diinstal.
Mengembalikan
Objek yang dapat diamati pemanggil untuk melacak kemajuan dan penyelesaian operasi. Setelah berhasil diselesaikan, hasilnya adalah objek StorePackageUpdateResult yang menyediakan info tentang pembaruan paket.
- Atribut
Pengecualian
Jika properti ErrorCode pengecualian memiliki nilai 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), ini menunjukkan bahwa metode tidak dipanggil pada utas UI. Jika Anda memanggil metode ini dalam aplikasi desktop yang menggunakan Desktop Bridge, ini juga dapat menunjukkan bahwa Anda tidak mengonfigurasi <objek xref:Windows.Services.Store.StoreContext?text=StoreContext> untuk menentukan jendela aplikasi mana yang merupakan jendela pemilik untuk dialog modal yang ditunjukkan oleh metode ini. Untuk informasi selengkapnya, lihat artikel ini.
Keterangan
Gunakan metode ini untuk mengunduh dan menginstal paket DLC baru untuk aplikasi saat ini. Saat Anda memanggil metode ini, OS menampilkan dialog yang memberi tahu pengguna bahwa paket aplikasi tersedia untuk diunduh dan diinstal, dan meminta izin pengguna untuk melanjutkan operasi. Jika pengguna tidak memberikan izin, properti OverallState dari nilai pengembalian StorePackageUpdateResult memiliki nilai Dibatalkan. Untuk menginstal paket aplikasi secara diam-diam tanpa menampilkan dialog pemberitahuan, gunakan DownloadAndInstallStorePackagesAsync (metode ini memerlukan akses ke kemampuan terbatas).
ID Penyimpanan untuk add-on DLC tersedia di Pusat Mitra, dan juga dikembalikan oleh properti StoreId dari StoreProduct yang mewakili add-on DLC. Untuk informasi selengkapnya, lihat ID Penyimpanan.
Operasi ini tidak akan memblokir. Objek IAsyncOperationWithProgress yang dikembalikan oleh metode ini akan selesai setelah paket diunduh dan diinstal.
Metode yang Anda tetapkan untuk menangani pemberitahuan Kemajuan dipanggil satu kali untuk setiap langkah dalam proses pengunduhan dan penginstalan untuk setiap paket dalam permintaan ini. Penanganan kemajuan menerima argumen StorePackageUpdateStatus yang menyediakan info tentang paket yang memunculkan pemberitahuan kemajuan.
Catatan
Paket konten yang dapat diunduh (DLC) tidak tersedia untuk semua akun pengembang.
Lihat juga
Berlaku untuk
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.
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parameter
ID Penyimpanan paket add-on DLC untuk diinstal.
- storePackageInstallOptions
- StorePackageInstallOptions
Objek yang menentukan opsi penginstalan untuk operasi.
Mengembalikan
Objek yang dapat diamati pemanggil untuk melacak kemajuan dan penyelesaian operasi. Setelah berhasil diselesaikan, hasilnya adalah objek StorePackageUpdateResult yang menyediakan info tentang pembaruan paket.
- Atribut
Pengecualian
Jika properti ErrorCode pengecualian memiliki nilai 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), ini menunjukkan bahwa metode tidak dipanggil pada utas UI. Jika Anda memanggil metode ini dalam aplikasi desktop yang menggunakan Desktop Bridge, ini juga dapat menunjukkan bahwa Anda tidak mengonfigurasi <objek xref:Windows.Services.Store.StoreContext?text=StoreContext> untuk menentukan jendela aplikasi mana yang merupakan jendela pemilik untuk dialog modal yang ditunjukkan oleh metode ini. Untuk informasi selengkapnya, lihat artikel ini.
Persyaratan Windows
| Rangkaian perangkat |
Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (diperkenalkan dalam v3.0)
|
Keterangan
Gunakan metode ini untuk mengunduh dan menginstal paket DLC baru untuk aplikasi saat ini. Kelebihan beban ini menyediakan opsi untuk menentukan apakah OS dapat memaksa aplikasi untuk memulai ulang setelah menginstal paket DLC dengan mengatur properti AllowForcedAppRestart dari parameter storePackageInstallOptions .
Saat Anda memanggil metode ini, OS menampilkan dialog yang memberi tahu pengguna bahwa paket aplikasi tersedia untuk diunduh dan diinstal, dan meminta izin pengguna untuk melanjutkan operasi. Jika pengguna tidak memberikan izin, properti OverallState dari nilai pengembalian StorePackageUpdateResult memiliki nilai Dibatalkan. Untuk menginstal paket aplikasi secara diam-diam tanpa menampilkan dialog pemberitahuan, gunakan DownloadAndInstallStorePackagesAsync (metode ini memerlukan akses ke kemampuan terbatas).
ID Penyimpanan untuk add-on DLC tersedia di Pusat Mitra, dan juga dikembalikan oleh properti StoreId dari StoreProduct yang mewakili add-on DLC. Untuk informasi selengkapnya, lihat ID Penyimpanan.
Operasi ini tidak akan memblokir. Objek IAsyncOperationWithProgress yang dikembalikan oleh metode ini akan selesai setelah paket diunduh dan diinstal.
Metode yang Anda tetapkan untuk menangani pemberitahuan Kemajuan dipanggil satu kali untuk setiap langkah dalam proses pengunduhan dan penginstalan untuk setiap paket dalam permintaan ini. Penanganan kemajuan menerima argumen StorePackageUpdateStatus yang menyediakan info tentang paket yang memunculkan pemberitahuan kemajuan.
Catatan
Paket DLC tidak tersedia untuk semua akun pengembang.
Lihat juga
Berlaku untuk
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