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 aux membres que vous pouvez utiliser pour accéder aux données relatives aux Microsoft Store et les gérer pour l’application actuelle. Par exemple, vous pouvez utiliser des membres de cette classe pour obtenir Microsoft Store description et les informations de licence de 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 une 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 pour obtenir des exemples de code, consultez Afficher les 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
| Configuration requise | Description |
|---|---|
| Famille d’appareils |
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
|
| API contract |
Windows.Services.Store.StoreContract (introduit dans v1.0)
|
Remarques
Note
Cette classe et le reste du Windows. Services.Store espace de noms a été introduit 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 version ultérieure dans Visual Studio. Si votre projet cible une version antérieure de Windows 10, vous devez utiliser le Windows. espace de noms ApplicationModel.Store au lieu du Windows. espace de noms Services.Store. Pour plus d’informations, consultez Achats in-app et essais.
La classe StoreContext est le point d’entrée principal du Windows. espace de noms Services.Store. Utilisez les membres de cette classe pour effectuer des tâches telles que l’obtention de Microsoft Store description et les informations de licence 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 des modules complémentaires pour l’application, des licences pour l’application et ses modules complémentaires, et Microsoft Store informations de référencement 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 (autrement dit, 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 aux données associées aux Microsoft Store et les gérer pour l’utilisateur. La plupart des applications de plateforme Windows universelle (UWP) sont des applications mono-utilisateurs.
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 aux données associées à Microsoft Store et les gérer 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 :
- Achats dans l'application et essais gratuits
- Obtenir des informations sur le produit pour les applications et les modules complémentaires
- Obtenir des informations de licence pour les applications et les modules complémentaires
- Activer les achats intégrés pour les applications et les modules complémentaires
- Activer les achats de consommables additionnels
- 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 les 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
| Nom | Description |
|---|---|
| CanSilentlyDownloadStorePackageUpdates |
Obtient une valeur qui indique si les mises à jour de package pour l’application actuelle peuvent être téléchargées sans afficher une 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
| Nom | Description |
|---|---|
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
Acquiert une licence pour le package d’extension DLC (Downloadable Content) spécifié pour l’application actuelle. |
| CanAcquireStoreLicenseAsync(String) |
Obtient une valeur qui indique si une licence peut être acquise pour le module complémentaire DLC (Downloadable Content) 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 spécifié (DLC) 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 de l’Microsoft Store sans afficher une boîte de dialogue d’interface utilisateur de notification à l’utilisateur. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
Obtient les détails du produit 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 disposent de mises à jour disponibles pour le téléchargement à partir de l’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 Microsoft Store informations de référencement pour les produits qui peuvent être achetés à partir de l’application actuelle. |
| GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>) |
Fournit aux membres que vous pouvez utiliser pour accéder aux données relatives aux Microsoft Store et les gérer pour l’application actuelle. Par exemple, vous pouvez utiliser des membres de cette classe pour obtenir Microsoft Store description et les informations de licence de 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 une 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 pour obtenir des exemples de code, consultez Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
| GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32) |
Obtient Microsoft Store informations de référencement 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 de 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 Microsoft Store qui peut être utilisée pour accorder des droits d’utilisation pour les produits gratuits pour le compte de l’utilisateur actuel. |
| GetDefault() |
Obtient un objet StoreContext qui peut être utilisé pour accéder aux données relatives aux Microsoft Store et les gérer dans le contexte de l’application actuelle. |
| GetForUser(User) |
Obtient un objet StoreContext qui peut être utilisé pour accéder aux données relatives aux Microsoft Store et les gérer pour l’utilisateur spécifié dans le contexte de l’application actuelle. |
| GetStoreProductForCurrentAppAsync() |
Obtient Microsoft Store informations de référencement de 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>, StoreProductOptions) |
Obtient Microsoft Store informations de référencement pour les produits spécifiés associés à l’application actuelle, avec l’option permettant d’utiliser un filtre pour la requête. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>) |
Obtient Microsoft Store informations de référencement pour les produits spécifiés associés à l’application actuelle. |
| 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 Microsoft Store informations pour les modules complémentaires de l’application actuelle pour laquelle l’utilisateur a acheté. |
| GetUserCollectionWithPagingAsync(IIterable<String>, UInt32) |
Obtient Microsoft Store informations 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 aux membres que vous pouvez utiliser pour accéder aux données relatives aux Microsoft Store et les gérer pour l’application actuelle. Par exemple, vous pouvez utiliser des membres de cette classe pour obtenir Microsoft Store description et les informations de licence de 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 une 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 pour obtenir des exemples de code, consultez Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Signale un module complémentaire consommable pour l’application actuelle comme rempli dans le Microsoft Store. |
| 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. |
| 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 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. |
| 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 fournit la possibilité de spécifier des détails supplémentaires pour une offre spécifique dans un grand catalogue de produits représentés par une seule description dans le Microsoft Store, y compris le nom du produit à afficher à l’utilisateur pendant l’achat. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. Important La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges. |
| 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. Important La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Fournit aux membres que vous pouvez utiliser pour accéder aux données relatives aux Microsoft Store et les gérer pour l’application actuelle. Par exemple, vous pouvez utiliser des membres de cette classe pour obtenir Microsoft Store description et les informations de licence de 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 une 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 pour obtenir des exemples de code, consultez Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
| RequestRateAndReviewAppAsync() |
Demande à l’utilisateur de évaluer et de passer en revue l’application. Cette méthode affiche l’interface utilisateur de l’utilisateur pour sélectionner une évaluation du Windows Store et ajouter une révision facultative du Windows Store pour le produit. Important Cette méthode doit être appelée sur le thread d’interface utilisateur. Important Le taux d’application et la fonctionnalité de révision ne sont pas pris en charge dans les applications avec élévation de privilèges. |
| RequestUninstallStorePackageAsync(Package) |
Tente de désinstaller le package facultatif spécifié pour l’application active. 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 active à partir de l’Microsoft Store sans afficher une 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 de l’Microsoft Store sans afficher une interface utilisateur de notification à l’utilisateur. |
| UninstallStorePackageAsync(Package) |
Désinstalle le package facultatif spécifié pour l’application actuelle sans afficher une 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 une boîte de dialogue d’interface utilisateur de notification à l’utilisateur. |
Événements
| Nom | Description |
|---|---|
| OfflineLicensesChanged |
Déclenché lorsque l’état de la licence de l’application change (par exemple, la période d’évaluation a expiré ou que l’utilisateur a acheté la version complète de l’application). |