StoreContext.RequestDownloadAndInstallStorePackagesAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Tente de télécharger et d’installer les packages de contenu téléchargeable (DLC) spécifiés pour l’application actuelle à partir du Microsoft Store. Cette méthode affiche également une boîte de dialogue d’interface utilisateur qui demande l’autorisation pour l’opération. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Tente de télécharger et d’installer les packages de contenu téléchargeable (DLC) spécifiés pour l’application actuelle à partir du Microsoft Store, avec les options d’installation spécifiées. Cette méthode affiche également une boîte de dialogue d’interface utilisateur qui demande l’autorisation pour l’opération. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Tente de télécharger et d’installer les packages de contenu téléchargeable (DLC) spécifiés pour l’application actuelle à partir du Microsoft Store. Cette méthode affiche également une boîte de dialogue d’interface utilisateur qui demande l’autorisation pour l’opération.
Important
Cette méthode doit être appelée sur le thread d’interface utilisateur.
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)Paramètres
ID store des packages de modules complémentaires DLC à installer.
Retours
Objet que l’appelant peut observer pour suivre la progression et l’achèvement de l’opération. Une fois l’exécution réussie, le résultat est un objet StorePackageUpdateResult qui fournit des informations sur les mises à jour du package.
- Attributs
Exceptions
Si la propriété ErrorCode de l’exception a la valeur 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), cela indique que la méthode n’a pas été appelée sur le thread d’interface utilisateur. Si vous appelez cette méthode dans une application de bureau qui utilise le Pont du bureau, cela peut également indiquer que vous n’avez pas configuré l’objet <xref:Windows.Services.StoreContext?text=StoreContext> pour spécifier quelle fenêtre d’application est la fenêtre propriétaire des boîtes de dialogue modales affichées par cette méthode. Pour plus d’informations, consultez cet article.
Remarques
Utilisez cette méthode pour télécharger et installer de nouveaux packages DLC pour l’application actuelle. Lorsque vous appelez cette méthode, le système d’exploitation affiche une boîte de dialogue qui indique à l’utilisateur qu’un package d’application est disponible pour le téléchargement et l’installation, et demande à l’utilisateur l’autorisation de poursuivre l’opération. Si l’utilisateur n’accorde pas d’autorisation, la propriété OverallState de la valeur de retour StorePackageUpdateResult a la valeur Canceled. Pour installer en mode silencieux un package d’application sans afficher de boîte de dialogue de notification, utilisez DownloadAndInstallStorePackagesAsync (cette méthode nécessite l’accès à une fonctionnalité restreinte).
L’ID Store d’un module complémentaire DLC est disponible dans l’Espace partenaires, et il est également retourné par la propriété StoreId du StoreProduct qui représente le module complémentaire DLC. Pour plus d’informations, consultez Store IDs.
Cette opération ne se bloque pas. L’objet IAsyncOperationWithProgress retourné par cette méthode se termine une fois les packages téléchargés et installés.
La méthode que vous attribuez pour gérer les notifications de progression est appelée une fois pour chaque étape du processus de téléchargement et d’installation pour chaque package de cette demande. Le gestionnaire Progress reçoit un argument StorePackageUpdateStatus qui fournit des informations sur le package qui a déclenché la notification de progression.
Notes
Les packages de contenu téléchargeable (DLC) ne sont pas disponibles pour tous les comptes de développeur.
Voir aussi
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Création de packages facultatifs et d’ensembles associés
S’applique à
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
Tente de télécharger et d’installer les packages de contenu téléchargeable (DLC) spécifiés pour l’application actuelle à partir du Microsoft Store, avec les options d’installation spécifiées. Cette méthode affiche également une boîte de dialogue d’interface utilisateur qui demande l’autorisation pour l’opération.
Important
Cette méthode doit être appelée sur le thread d’interface utilisateur.
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)Paramètres
ID store des packages de modules complémentaires DLC à installer.
- storePackageInstallOptions
- StorePackageInstallOptions
Objet qui spécifie les options d’installation de l’opération.
Retours
Objet que l’appelant peut observer pour suivre la progression et l’achèvement de l’opération. Une fois l’exécution réussie, le résultat est un objet StorePackageUpdateResult qui fournit des informations sur les mises à jour du package.
- Attributs
Exceptions
Si la propriété ErrorCode de l’exception a la valeur 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), cela indique que la méthode n’a pas été appelée sur le thread d’interface utilisateur. Si vous appelez cette méthode dans une application de bureau qui utilise le Pont du bureau, cela peut également indiquer que vous n’avez pas configuré l’objet <xref:Windows.Services.StoreContext?text=StoreContext> pour spécifier quelle fenêtre d’application est la fenêtre propriétaire des boîtes de dialogue modales affichées par cette méthode. Pour plus d’informations, consultez cet article.
Configuration requise pour Windows
| Famille d’appareils |
Windows 10, version 1803 (introduit dans 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (introduit dans v3.0)
|
Remarques
Utilisez cette méthode pour télécharger et installer de nouveaux packages DLC pour l’application actuelle. Cette surcharge permet de spécifier si le système d’exploitation peut forcer le redémarrage de l’application après l’installation des packages DLC en définissant la propriété AllowForcedAppRestart du paramètre storePackageInstallOptions .
Lorsque vous appelez cette méthode, le système d’exploitation affiche une boîte de dialogue qui indique à l’utilisateur qu’un package d’application est disponible pour le téléchargement et l’installation, et demande à l’utilisateur l’autorisation de poursuivre l’opération. Si l’utilisateur n’accorde pas d’autorisation, la propriété OverallState de la valeur de retour StorePackageUpdateResult a la valeur Canceled. Pour installer en mode silencieux un package d’application sans afficher de boîte de dialogue de notification, utilisez DownloadAndInstallStorePackagesAsync (cette méthode nécessite l’accès à une fonctionnalité restreinte).
L’ID Store d’un module complémentaire DLC est disponible dans l’Espace partenaires, et il est également retourné par la propriété StoreId du StoreProduct qui représente le module complémentaire DLC. Pour plus d’informations, consultez Store IDs.
Cette opération ne se bloque pas. L’objet IAsyncOperationWithProgress retourné par cette méthode se termine une fois les packages téléchargés et installés.
La méthode que vous attribuez pour gérer les notifications de progression est appelée une fois pour chaque étape du processus de téléchargement et d’installation pour chaque package de cette demande. Le gestionnaire Progress reçoit un argument StorePackageUpdateStatus qui fournit des informations sur le package qui a déclenché la notification de progression.
Notes
Les packages DLC ne sont pas disponibles pour tous les comptes de développeur.
Voir aussi
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Création de packages facultatifs et d’ensembles associés