StoreContext Classe
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.
Fournit des membres que vous pouvez utiliser pour accéder et gérer les données liées au Microsoft Store pour l’application actuelle. Par exemple, vous pouvez utiliser les membres de cette classe pour obtenir la liste et les informations de licence du Microsoft Store pour l’application actuelle, acheter l’application ou les produits actuels proposés par l’application, ou télécharger et installer des mises à jour de package pour l’application.
Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de 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- Héritage
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
|
| API contract |
Windows.Services.Store.StoreContract (introduit dans v1.0)
|
Remarques
Notes
Cette classe et le reste de l’espace de noms Windows.Services.Store ont été introduits dans Windows 10 version 1607. Cette classe ne peut être utilisée que dans les projets qui ciblent Windows 10 Édition anniversaire (10.0 ; Build 14393) ou une version ultérieure dans Visual Studio. Si votre projet cible une version antérieure de Windows 10, vous devez utiliser l’espace de noms Windows.ApplicationModel.Store plutôt que l’espace de noms Windows.Services.Store. Pour plus d’informations, consultez Versions d’évaluation et achats in-app.
La classe StoreContext est le point d’entrée main de l’espace de noms Windows.Services.Store. Utilisez les membres de cette classe pour effectuer des tâches telles que l’obtention de la liste et des informations de licence du Microsoft Store pour l’application actuelle, l’achat de l’application ou des modules complémentaires actuels proposés par l’application, ou le téléchargement et l’installation des mises à jour de package pour l’application. D’autres classes et types dans cet espace de noms représentent des éléments tels que les modules complémentaires pour l’application, les licences de l’application et ses modules complémentaires et les informations de liste du Microsoft Store pour l’application.
Pour obtenir un objet StoreContext, utilisez l’une des méthodes statiques suivantes :
GetDefault : utilisez cette méthode dans les applications mono-utilisateur (c’est-à-dire les applications qui s’exécutent uniquement dans le contexte de l’utilisateur qui a lancé l’application). Cette méthode obtient un objet StoreContext que vous pouvez utiliser pour accéder et gérer des données liées au Microsoft Store pour l’utilisateur. La plupart des applications de plateforme Windows universelle (UWP) sont des applications mono-utilisateur.
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();GetForUser : utilisez cette méthode dans les applications multi-utilisateurs. Cette méthode obtient un objet StoreContext que vous pouvez utiliser pour accéder et gérer des données liées au Microsoft Store pour un utilisateur spécifique. Pour plus d’informations sur les applications multi-utilisateurs, consultez Présentation des applications multi-utilisateurs.
var users = await Windows.System.User.FindAllAsync(); Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
Une fois que vous avez un objet StoreContext, vous pouvez commencer à appeler des méthodes pour acheter une application ou un module complémentaire pour l’utilisateur actuel et d’autres tâches. Pour plus d’informations, consultez les articles suivants :
- Versions d’évaluation et achats in-app
- Obtenir les informations produit des applications et des extensions
- Obtenir les informations de licence des applications et des modules complémentaires
- Activer les achats in-app d’applications et de modules complémentaires
- Activer les achats de modules complémentaires consommables
- Implémenter une version d’évaluation de votre application
Vous pouvez également utiliser un objet StoreContext pour télécharger et installer des mises à jour de package pour l’application. Pour plus d’informations, consultez Télécharger et installer des mises à jour de package pour votre application.
Historique des versions
| Version de Windows | Version du SDK | Valeur ajoutée |
|---|---|---|
| 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 |
Propriétés
| CanSilentlyDownloadStorePackageUpdates |
Obtient une valeur qui indique si les mises à jour de package pour l’application actuelle peuvent être téléchargées sans afficher d’interface utilisateur de notification à l’utilisateur. |
| User |
Obtient des informations sur l’utilisateur associé à l’objet StoreContext actuel dans une application multi-utilisateur. |
Méthodes
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
Acquiert une licence pour le package de complément de contenu téléchargeable (DLC) spécifié pour l’application actuelle. |
| CanAcquireStoreLicenseAsync(String) |
Obtient une valeur qui indique si une licence peut être acquise pour le module complémentaire de contenu téléchargeable (DLC) spécifié de l’application actuelle pour l’utilisateur actuel. |
| CanAcquireStoreLicenseForOptionalPackageAsync(Package) |
Obtient une valeur qui indique si une licence peut être acquise pour le package de contenu téléchargeable (DLC) spécifié de l’application actuelle pour l’utilisateur actuel. |
| DownloadAndInstallStorePackagesAsync(IIterable<String>) |
Télécharge et installe les packages de contenu téléchargeable (DLC) spécifiés pour l’application actuelle à partir du Microsoft Store sans afficher de boîte de dialogue d’interface utilisateur de notification à l’utilisateur. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
Obtient les détails du produit du Store pour l’application ou le module complémentaire associé au package spécifié. |
| GetAppAndOptionalStorePackageUpdatesAsync() |
Obtient la collection de packages pour l’application actuelle qui ont des mises à jour disponibles en téléchargement à partir du Microsoft Store, y compris les packages facultatifs pour l’application. |
| GetAppLicenseAsync() |
Obtient les informations de licence pour l’application actuelle, y compris les licences pour les modules complémentaires pour l’application actuelle. |
| GetAssociatedStoreProductsAsync(IIterable<String>) |
Obtient les informations de liste du Microsoft Store pour les produits qui peuvent être achetés à partir de l’application actuelle. |
| GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>) |
Fournit des membres que vous pouvez utiliser pour accéder et gérer les données liées au Microsoft Store pour l’application actuelle. Par exemple, vous pouvez utiliser les membres de cette classe pour obtenir la liste et les informations de licence du Microsoft Store pour l’application actuelle, acheter l’application ou les produits actuels proposés par l’application, ou télécharger et installer des mises à jour de package pour l’application. Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
| GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32) |
Obtient les informations de liste du Microsoft Store pour les produits qui peuvent être achetés à partir de l’application actuelle. Cette méthode prend en charge la pagination pour retourner les résultats. |
| GetAssociatedStoreQueueItemsAsync() |
Obtient des informations sur tous les packages nouveaux ou mis à jour qui se trouvent dans la file d’attente de téléchargement et d’installation de l’application actuelle. |
| GetConsumableBalanceRemainingAsync(String) |
Obtient le solde restant pour le module complémentaire consommable spécifié pour l’application actuelle. |
| GetCustomerCollectionsIdAsync(String, String) |
Récupère une clé d’ID du Microsoft Store qui peut être utilisée pour rechercher des droits de produit ou pour consommer des droits de produit appartenant à l’utilisateur actuel. |
| GetCustomerPurchaseIdAsync(String, String) |
Récupère une clé d’ID du Microsoft Store qui peut être utilisée pour accorder des droits pour les produits gratuits pour le compte de l’utilisateur actuel. |
| GetDefault() |
Obtient un objet StoreContext qui peut être utilisé pour accéder et gérer des données liées au Microsoft Store pour l’utilisateur actuel dans le contexte de l’application actuelle. |
| GetForUser(User) |
Obtient un objet StoreContext qui peut être utilisé pour accéder et gérer des données liées au Microsoft Store pour l’utilisateur spécifié dans le contexte de l’application actuelle. |
| GetStoreProductForCurrentAppAsync() |
Obtient les informations de référencement du Microsoft Store pour l’application actuelle et fournit l’accès à une méthode que vous pouvez utiliser pour acheter l’application pour l’utilisateur actuel. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>) |
Obtient les informations de description du Microsoft Store pour les produits spécifiés qui sont associés à l’application actuelle. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions) |
Obtient les informations de liste du Microsoft Store pour les produits spécifiés qui sont associés à l’application actuelle, avec la possibilité d’utiliser un filtre pour la requête. |
| GetStoreQueueItemsAsync(IIterable<String>) |
Obtient des informations sur les packages nouveaux ou mis à jour spécifiés qui se trouvent dans la file d’attente de téléchargement et d’installation de l’application actuelle. |
| GetUserCollectionAsync(IIterable<String>) |
Obtient les informations du Microsoft Store pour les modules complémentaires de l’application actuelle pour laquelle l’utilisateur a acheté. |
| GetUserCollectionWithPagingAsync(IIterable<String>, UInt32) |
Obtient les informations du Microsoft Store pour les modules complémentaires de l’application actuelle pour laquelle l’utilisateur a acheté. Cette méthode prend en charge la pagination pour retourner les résultats. |
| GetUserPurchaseHistoryAsync(IIterable<String>) |
Fournit des membres que vous pouvez utiliser pour accéder et gérer les données liées au Microsoft Store pour l’application actuelle. Par exemple, vous pouvez utiliser les membres de cette classe pour obtenir la liste et les informations de licence du Microsoft Store pour l’application actuelle, acheter l’application ou les produits actuels proposés par l’application, ou télécharger et installer des mises à jour de package pour l’application. Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Signale un module complémentaire consommable pour l’application actuelle tel qu’il est rempli dans le Microsoft Store. |
| 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. |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tente de télécharger et d’installer 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. |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
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. |
| RequestPurchaseAsync(String) |
Demande l’achat de l’application ou du module complémentaire spécifié et affiche l’interface utilisateur utilisée pour terminer la transaction via le Microsoft Store. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
Demande l’achat de l’application ou du module complémentaire spécifié et affiche l’interface utilisateur utilisée pour terminer la transaction via le Microsoft Store. Cette méthode offre la possibilité de spécifier des détails supplémentaires pour une offre spécifique dans un grand catalogue de produits qui sont représentés par une seule description dans le Microsoft Store, y compris le nom du produit à afficher à l’utilisateur lors de l’achat. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Fournit des membres que vous pouvez utiliser pour accéder et gérer les données liées au Microsoft Store pour l’application actuelle. Par exemple, vous pouvez utiliser les membres de cette classe pour obtenir la liste et les informations de licence du Microsoft Store pour l’application actuelle, acheter l’application ou les produits actuels proposés par l’application, ou télécharger et installer des mises à jour de package pour l’application. Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
| RequestRateAndReviewAppAsync() |
Demande à l’utilisateur d’évaluer et de passer en revue l’application. Cette méthode affiche l’interface utilisateur pour que l’utilisateur sélectionne une évaluation du Store et ajoute une révision facultative du Store pour le produit. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. |
| RequestUninstallStorePackageAsync(Package) |
Tente de désinstaller le package facultatif spécifié pour l’application actuelle. Cette méthode affiche également une boîte de dialogue d’interface utilisateur qui demande l’autorisation pour l’opération. |
| RequestUninstallStorePackageByStoreIdAsync(String) |
Tente de désinstaller le package de contenu téléchargeable (DLC) spécifié pour l’application actuelle. Cette méthode affiche également une boîte de dialogue d’interface utilisateur qui demande l’autorisation pour l’opération. |
| SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>) |
Définit l’ordre dans lequel installer les packages spécifiés dans la file d’attente de téléchargement et d’installation de l’application actuelle. |
| TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tente de télécharger et d’installer les mises à jour de package spécifiées pour l’application actuelle à partir du Microsoft Store sans afficher d’interface utilisateur de notification à l’utilisateur. |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tente de télécharger les mises à jour de package spécifiées pour l’application actuelle à partir du Microsoft Store sans afficher d’interface utilisateur de notification à l’utilisateur. |
| UninstallStorePackageAsync(Package) |
Désinstalle le package facultatif spécifié pour l’application actuelle sans afficher de boîte de dialogue d’interface utilisateur de notification à l’utilisateur. |
| UninstallStorePackageByStoreIdAsync(String) |
Désinstalle le package de contenu téléchargeable (DLC) spécifié pour l’application actuelle sans afficher de boîte de dialogue d’interface utilisateur de notification à l’utilisateur. |
Événements
| OfflineLicensesChanged |
Déclenché lorsque le status de la licence de l’application change (par exemple, la période d’évaluation a expiré ou l’utilisateur a acheté la version complète de l’application). |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour