CurrentApp 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义可用于获取有关当前应用的许可证和列表信息以及执行应用内产品购买的方法和属性。
注意
CurrentApp 类和 Windows.ApplicationModel.Store 命名空间中的其他类型不再使用新功能进行更新。 如果你的项目面向 Windows 10 周年版 （10.0;内部版本 14393） 或更高版本的 Visual Studio（即，面向 Windows 10 版本 1607 或更高版本），建议改用 Windows.Services.Store 命名空间。 有关详细信息，请参阅 应用内购买和试用版。 CurrentApp 类在 Windows 桌面应用程序中不受支持，这些应用程序使用 桌面桥 或在 合作伙伴中心 中使用开发沙盒的应用或游戏中（例如，与 Xbox Live 集成的任何游戏都是这样）。 这些产品必须使用 Windows.Services.Store 命名空间来实现应用内购买和试用。
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- 继承
- 属性
Windows 要求
| 要求 | 说明 |
|---|---|
| 设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
注解
此对象从 Microsoft Store 获取其数据，因此必须具有开发人员帐户，并且应用必须在 Microsoft Store 中发布。 在提交到 Microsoft Store 之前，可以使用此类的模拟版本（其状态从 XML 文件初始化）测试代码。 请参阅 CurrentAppSimulator。
版本历史记录
| Windows 版本 | SDK 版本 | 已添加值 |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
属性
| 名称 | 说明 |
|---|---|
| AppId |
获取 Windows 应用商店生成的 GUID，该应用已获得 Windows 应用商店中列表的认证。 注意 应用进入 Windows 应用商店后，将来的应用更新或更改应用说明不会对 CurrentApp.AppId 进行更改。 |
| LicenseInformation |
获取当前应用的许可证元数据。 |
| LinkUri |
获取 Windows 应用商店 Web 目录中应用列表页的统一资源标识符（URI）。 |
方法
| 名称 | 说明 |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
检索当前应用的促销活动 ID。 |
| GetAppReceiptAsync() |
请求购买应用和任何应用内产品的所有收据。 有关如何使用收据信息的示例，请参阅 使用收据验证产品购买。 |
| GetCustomerCollectionsIdAsync(String, String) |
检索可用于查询产品权利或使用当前用户拥有的产品权利Microsoft应用商店 ID 密钥。 |
| GetCustomerPurchaseIdAsync(String, String) |
检索一个Microsoft应用商店 ID 密钥，该密钥可用于代表当前用户授予免费产品的权利。 |
| GetProductReceiptAsync(String) |
请求指定产品 ID 的收据。 有关如何使用收据信息的示例，请参阅 使用收据验证产品购买。 |
| GetUnfulfilledConsumablesAsync() |
返回尚未向 Microsoft 应用商店报告的已购买易耗品应用内产品的列表。 |
| LoadListingInformationAsync() |
异步加载应用的列表信息。 返回的 ListingInformation 对象包含特定于用户当前所在的市场的列表信息（例如名称、价格、年龄分级）。 此外，还提供了应用内产品的列表信息。 |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
异步加载应用列表信息，返回与所有提供的关键字匹配的 ProductListings 集合中的功能和产品。 |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
异步加载应用列表信息，返回与任何给定产品 ID 匹配的 ProductListings 集合中的功能和产品。 |
| ReportConsumableFulfillmentAsync(String, Guid) |
通知Microsoft应用商店，购买易耗型加载项（也称为应用内产品或 IAP）已完成，并且用户有权访问内容。 |
| ReportProductFulfillment(String) |
通知Microsoft应用商店应用程序已完成应用内产品。 只有在应用使用此方法确认履行之前，才能重新购买此产品。 |
| RequestAppPurchaseAsync(Boolean) |
Important 提升的应用程序不支持应用内购买功能。 请求购买完整的应用许可证。 |
| RequestProductPurchaseAsync(String, Boolean) |
Important 提升的应用程序不支持应用内购买功能。 注意 [RequestProductPurchaseAsync（String， Boolean） 可能会在Windows 8.1后更改或不可用。 请改用 RequestProductPurchaseAsync（String）。 请求购买加载项（也称为应用内产品或 IAP）。 此外，调用此方法将显示用于通过 Microsoft Store 完成事务的 UI。 |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Important 提升的应用程序不支持应用内购买功能。 请求购买加载项（也称为应用内产品或 IAP）。 此外，调用此方法将显示用于通过 Microsoft Store 完成事务的 UI。 此重载包括可用于在应用商店中单个产品条目表示的大型应用内购买目录中显示特定产品/服务的详细信息的参数。 |
| RequestProductPurchaseAsync(String) |
Important 提升的应用程序不支持应用内购买功能。 请求购买加载项（也称为应用内产品或 IAP）。 此外，调用此方法将显示用于通过 Microsoft Store 完成事务的 UI。 |