CurrentApp 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.
Définit les méthodes et les propriétés que vous pouvez utiliser pour obtenir des informations de licence et de liste sur l’application actuelle et effectuer des achats de produits dans l’application.
Notes
La classe CurrentApp et les autres types de l’espace de noms Windows.ApplicationModel.Store ne sont plus mis à jour avec de nouvelles fonctionnalités. Si votre projet cible Windows 10 édition anniversaire (10.0 ; Build 14393) ou une version ultérieure dans Visual Studio (autrement dit, vous ciblez Windows 10, version 1607 ou ultérieure), nous vous recommandons d’utiliser l’espace de noms Windows.Services.Store à la place. Pour plus d’informations, consultez Versions d’évaluation et achats in-app. La classe CurrentApp n’est pas prise en charge dans les applications de bureau Windows qui utilisent le Pont du bureau ou dans les applications ou jeux qui utilisent un bac à sable de développement dans l’Espace partenaires (par exemple, c’est le cas pour tout jeu qui s’intègre à Xbox Live). Ces produits doivent utiliser l’espace de noms Windows.Services.Store pour implémenter des achats et des versions d’évaluation dans l’application.
public ref class CurrentApp abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentApp final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class CurrentApp
Public Class CurrentApp
- Héritage
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Remarques
Cet objet obtient ses données à partir du Microsoft Store. Vous devez donc disposer d’un compte de développeur et l’application doit être publiée dans le Microsoft Store. Avant de l’envoyer au Microsoft Store, vous pouvez tester votre code avec une version simulée de cette classe (dont l’état est initialisé à partir d’un fichier XML). Consultez CurrentAppSimulator.
Historique des versions
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1511 | 10586 | GetCustomerCollectionsIdAsync |
1511 | 10586 | GetCustomerPurchaseIdAsync |
Propriétés
AppId |
Obtient le GUID généré par le Windows Store lorsque votre application a été certifiée pour être listée dans le Windows Store. Notes Une fois votre application dans le Windows Store, les futures mises à jour d’application ou les modifications apportées à la description de l’application n’entraînent pas de modification de CurrentApp.AppId. |
LicenseInformation |
Obtient les métadonnées de licence pour l’application actuelle. |
LinkUri |
Obtient l’URI (Uniform Resource Identifier) de la page de référencement de l’application dans le catalogue web du Windows Store. |
Méthodes
GetAppPurchaseCampaignIdAsync() |
Récupère l’ID de la campagne de promotion pour l’application actuelle. |
GetAppReceiptAsync() |
Demande tous les reçus pour l’achat de l’application et de tous les produits dans l’application. Pour obtenir des exemples d’utilisation des informations sur les reçus, consultez Utilisation de reçus pour vérifier les achats de produits. |
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. |
GetProductReceiptAsync(String) |
Demande le reçu pour l’ID de produit spécifié. Pour obtenir des exemples d’utilisation des informations sur les reçus, consultez Utilisation de reçus pour vérifier les achats de produits. |
GetUnfulfilledConsumablesAsync() |
Retourne une liste des produits consommables achetés dans l’application qui n’ont pas été signalés au Microsoft Store comme étant remplis. |
LoadListingInformationAsync() |
Charge les informations de référencement de l’application de manière asynchrone. L’objet ListingInformation retourné contient des informations de liste (par exemple, nom, prix, évaluation de l’âge) spécifiques au marché où réside actuellement l’utilisateur. En outre, les informations de liste des produits disponibles dans l’application sont également fournies. |
LoadListingInformationByKeywordsAsync(IIterable<String>) |
Charge de manière asynchrone les informations de liste des applications, en retournant les fonctionnalités et les produits de la collection ProductListings qui correspondent à tous les mots clés fournis. |
LoadListingInformationByProductIdsAsync(IIterable<String>) |
Charge les informations de liste des applications de manière asynchrone, renvoyant les fonctionnalités et les produits de la collection ProductListings qui correspondent à l’un des ID de produits donnés. |
ReportConsumableFulfillmentAsync(String, Guid) |
Avertit le Microsoft Store que l’achat d’un module complémentaire consommable (également appelé produit in-app ou IAP) est effectué et que l’utilisateur a le droit d’accéder au contenu. |
ReportProductFulfillment(String) |
Avertit le Microsoft Store que l’application a rempli le produit dans l’application. Ce produit ne peut pas être ré-acheté tant que l’application n’a pas confirmé l’exécution à l’aide de cette méthode. |
RequestAppPurchaseAsync(Boolean) |
Demande l’achat d’une licence d’application complète. |
RequestProductPurchaseAsync(String) |
Demande l’achat d’un module complémentaire (également appelé produit in-app ou IAP). En outre, l’appel de cette méthode affiche l’interface utilisateur utilisée pour terminer la transaction via le Microsoft Store. |
RequestProductPurchaseAsync(String, Boolean) |
Notes [RequestProductPurchaseAsync(String, Boolean) peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt RequestProductPurchaseAsync(String). Demande l’achat d’un module complémentaire (également appelé produit in-app ou IAP). En outre, l’appel de cette méthode affiche l’interface utilisateur utilisée pour terminer la transaction via le Microsoft Store. |
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Demande l’achat d’un module complémentaire (également appelé produit in-app ou IAP). En outre, l’appel de cette méthode affiche l’interface utilisateur utilisée pour terminer la transaction via le Microsoft Store. Cette surcharge inclut des paramètres que vous pouvez utiliser pour afficher les détails d’une offre spécifique dans un grand catalogue d’achats in-app qui est représenté par une seule entrée de produit dans le Store. |