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 des méthodes et des 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.
Note
Classe CurrentApp et les autres types dans le Windows. ApplicationModel.Store espace de noms ne sont plus mis à jour avec de nouvelles fonctionnalités. Si votre projet cible Édition anniversaire Windows 10 (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 Achats in-app et essais. La classe CurrentApp n’est pas prise en charge dans Windows applications de bureau qui utilisent le Desktop Bridge ou dans des applications ou des jeux qui utilisent un bac à sable de développement dans Partner Center (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 CurrentAppPublic Class CurrentApp- Héritage
- Attributs
Configuration requise pour Windows
| Configuration requise | Description |
|---|---|
| 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 de l’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 soumettre 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
| Nom | Description |
|---|---|
| AppId |
Obtient le GUID généré par le Windows Store lorsque votre application a été certifiée pour la description dans le Windows Store. Note Une fois votre application dans le Windows Store, les futures mises à jour ou 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 de 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 magasin Windows. |
Méthodes
| Nom | Description |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
Récupère l’ID de campagne de promotion de 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 de l’utilisation des informations de reçu, consultez Utilisation des reçus pour vérifier les achats de produits. |
| 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. |
| GetProductReceiptAsync(String) |
Demande le reçu pour l’ID de produit spécifié. Pour obtenir des exemples de l’utilisation des informations de reçu, consultez Utilisation des reçus pour vérifier les achats de produits. |
| GetUnfulfilledConsumablesAsync() |
Retourne la liste des produits consommables dans l’application qui n’ont pas été signalés au Microsoft Store comme satisfait. |
| LoadListingInformationAsync() |
Charge les informations de référencement de l’application de manière asynchrone. L’objet ListingInformation retourné contient des informations de référencement (par exemple, nom, prix, évaluation de l’âge) propres au marché dans lequel réside actuellement l’utilisateur. En outre, les informations de référencement des produits dans l’application disponibles sont également fournies. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Charge les informations de liste d’applications de manière asynchrone, en retournant des fonctionnalités et des produits dans la collection ProductListings qui correspondent à tous les mots clés fournis. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Charge les informations de référencement d’applications de manière asynchrone, en retournant des fonctionnalités et des produits dans 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 rempli 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) |
Important La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges. Demande l’achat d’une licence d’application complète. |
| RequestProductPurchaseAsync(String, Boolean) |
Important La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges. Note [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) |
Important La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges. 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 représentés par une entrée de produit unique dans le Windows Store. |
| RequestProductPurchaseAsync(String) |
Important La fonctionnalité d’achat dans l’application n’est pas prise en charge dans les applications avec élévation de privilèges. 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. |