StoreContext.RequestDownloadStorePackageUpdatesAsync 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.
Tente de télécharger les mises à jour de package spécifiées 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> ^ RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate ^> ^ storePackageUpdates) = RequestDownloadStorePackageUpdatesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate> const& storePackageUpdates);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IEnumerable<StorePackageUpdate> storePackageUpdates);function requestDownloadStorePackageUpdatesAsync(storePackageUpdates)Public Function RequestDownloadStorePackageUpdatesAsync (storePackageUpdates As IEnumerable(Of StorePackageUpdate)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Paramètres
- storePackageUpdates
Ensemble d’objets StorePackageUpdate qui représentent les packages mis à jour à télécharger.
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
Pour obtenir la liste des packages qui ont des mises à jour disponibles, utilisez la méthode GetAppAndOptionalStorePackageUpdatesAsync . Après avoir téléchargé les packages, vous pouvez les installer à l’aide de la méthode RequestDownloadAndInstallStorePackageUpdatesAsync . Pour plus d’informations sur l’utilisation de cette méthode, y compris un exemple de code, consultez Télécharger et installer des mises à jour de package pour votre application.
Cette opération ne se bloque pas. L’objet IAsyncOperationWithProgress retourné par cette méthode se termine une fois les packages de mise à jour téléchargés.
Lorsque vous appelez cette méthode, le système d’exploitation affiche une boîte de dialogue qui indique à l’utilisateur qu’une mise à jour d’application est disponible à télécharger et demande à l’utilisateur l’autorisation de poursuivre le téléchargement. Si l’utilisateur n’accorde pas l’autorisation de démarrer le téléchargement, la propriété OverallState de la valeur de retour StorePackageUpdateResult a la valeur Canceled.
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 pour chaque package de cette demande. Le gestionnaire Progress reçoit un argument StorePackageUpdateStatus qui fournit des informations sur le package de mise à jour qui a déclenché la notification de progression.