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 active à partir de l’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. En cas de réussite, 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 de bureau, cela peut également indiquer que vous n’avez pas configuré le <xref="Windows. Services.Store.StoreContext ?text=StoreContext" /> objet 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, notamment un exemple de code, consultez Télécharger et installer les mises à jour de package pour votre application.
Cette opération ne 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 pour 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 affectez pour gérer les notifications Progress est appelée une fois pour chaque étape du processus de téléchargement de 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.