CurrentApp.RequestProductPurchaseAsync 方法

定义

命名空间:

Windows.ApplicationModel.Store

重载

RequestProductPurchaseAsync(String)	请求购买加载项 (也称为应用内产品或 IAP) 。 此外，调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。
RequestProductPurchaseAsync(String, Boolean)	注意 [RequestProductPurchaseAsync (字符串、布尔) 可能会在Windows 8.1后更改或不可用。 请改用 RequestProductPurchaseAsync (String) 。 请求购买加载项 (也称为应用内产品或 IAP) 。 此外，调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	请求购买加载项 (也称为应用内产品或 IAP) 。 此外，调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。 此重载包括可用于在应用商店中单个产品条目表示的大型应用内购买目录中特定产品/服务的详细信息的参数。

RequestProductPurchaseAsync(String)

请求购买加载项 (也称为应用内产品或 IAP) 。 此外，调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。

public:
 static IAsyncOperation<PurchaseResults ^> ^ RequestProductPurchaseAsync(Platform::String ^ productId);

/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithResultsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(winrt::hstring const& productId);

[Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithResultsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(string productId);

function requestProductPurchaseAsync(productId)

Public Shared Function RequestProductPurchaseAsync (productId As String) As IAsyncOperation(Of PurchaseResults)

参数

productId

String

Platform::String

winrt::hstring

要购买的加载项的产品 ID。

返回

IAsyncOperation<PurchaseResults>

一个 PurchaseResults ，其中包含应用内产品购买请求的结果。

属性

OverloadAttribute RemoteAsyncAttribute

注解

产品 ID 是应用用于标识加载项的字符串。 在合作伙伴中心提交加载项时，可以输入产品 ID，该 ID 与说明、价格层和生存期相关联。 有关详细信息，请参阅 如何在代码中使用加载项的产品 ID。

可以在 代码示例中查看有关如何使用此方法的示例。

另请参阅

• RequestProductPurchaseAsync(String, Boolean)

RequestProductPurchaseAsync(String, Boolean)

注意

[RequestProductPurchaseAsync (字符串、布尔) 可能会在Windows 8.1后更改或不可用。 请改用 RequestProductPurchaseAsync (String) 。

请求购买加载项 (也称为应用内产品或 IAP) 。 此外，调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。

public:
 static IAsyncOperation<Platform::String ^> ^ RequestProductPurchaseAsync(Platform::String ^ productId, bool includeReceipt);

/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("RequestProductPurchaseAsync(productId, includeReceipt) may be altered or unavailable for releases after Windows 8.1. Instead, use RequestProductPurchaseAsync(productId).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 static IAsyncOperation<winrt::hstring> RequestProductPurchaseAsync(winrt::hstring const& productId, bool const& includeReceipt);

[Windows.Foundation.Metadata.Overload("RequestProductPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Deprecated("RequestProductPurchaseAsync(productId, includeReceipt) may be altered or unavailable for releases after Windows 8.1. Instead, use RequestProductPurchaseAsync(productId).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public static IAsyncOperation<string> RequestProductPurchaseAsync(string productId, bool includeReceipt);

function requestProductPurchaseAsync(productId, includeReceipt)

Public Shared Function RequestProductPurchaseAsync (productId As String, includeReceipt As Boolean) As IAsyncOperation(Of String)

参数

productId

String

Platform::String

winrt::hstring

要购买的加载项的产品 ID。

includeReceipt

Boolean

bool

确定方法是否应返回指定 productId 的回执。

返回

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

为提供的 productId 提供应用内事务详细信息的字符串。 如果 includeReceipt 设置为 true，则返回的字符串将包含完整的回执 xml。

属性

DeprecatedAttribute OverloadAttribute RemoteAsyncAttribute

注解

RequestProductPurchaseAsync (String) 注释也适用于此重载。

若要在成功调用此重载后确认产品许可证是否处于活动状态，请使用 LicenseInformation.IsActive 属性。

另请参阅

• RequestProductPurchaseAsync(String)

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

请求购买加载项 (也称为应用内产品或 IAP) 。 此外，调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。 此重载包括可用于在应用商店中单个产品条目表示的大型应用内购买目录中特定产品/服务的详细信息的参数。

public:
 static IAsyncOperation<PurchaseResults ^> ^ RequestProductPurchaseAsync(Platform::String ^ productId, Platform::String ^ offerId, ProductPurchaseDisplayProperties ^ displayProperties);

/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithDisplayPropertiesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(winrt::hstring const& productId, winrt::hstring const& offerId, ProductPurchaseDisplayProperties const& displayProperties);

[Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithDisplayPropertiesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(string productId, string offerId, ProductPurchaseDisplayProperties displayProperties);

function requestProductPurchaseAsync(productId, offerId, displayProperties)

Public Shared Function RequestProductPurchaseAsync (productId As String, offerId As String, displayProperties As ProductPurchaseDisplayProperties) As IAsyncOperation(Of PurchaseResults)

参数

productId

String

Platform::String

winrt::hstring

要购买的加载项的产品 ID。

offerId

String

Platform::String

winrt::hstring

Microsoft Store 上由 productId 表示的大型购买目录中的特定应用内功能或内容。此值与应用负责完成的内容相关联。 Microsoft Store 仅使用此值来逐项化 PurchaseResults。

displayProperties

ProductPurchaseDisplayProperties

购买时向用户显示的应用功能或内容产品/服务的名称。

返回

IAsyncOperation<PurchaseResults>

一个 PurchaseResults ，其中包含应用内产品购买请求的结果。

属性

OverloadAttribute RemoteAsyncAttribute

注解

RequestProductPurchaseAsync (String) 注释也适用于此重载。

另请参阅

• RequestProductPurchaseAsync(String)
• RequestProductPurchaseAsync(String, Boolean)