StoreContext.RequestPurchaseAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
RequestPurchaseAsync(String, StorePurchaseProperties) |
要求購買指定的應用程式或附加元件,並顯示用來透過 Microsoft Store 完成交易的 UI。 這個方法提供選項,以在 Microsoft Store 中的單一清單所代表的大型產品目錄中,指定特定供應專案的其他詳細資料,包括在購買期間向使用者顯示的產品名稱。 重要 這個方法必須在 UI 執行緒上呼叫。 |
RequestPurchaseAsync(String) |
要求購買指定的應用程式或附加元件,並顯示用來透過 Microsoft Store 完成交易的 UI。 重要 這個方法必須在 UI 執行緒上呼叫。 |
RequestPurchaseAsync(String, StorePurchaseProperties)
要求購買指定的應用程式或附加元件,並顯示用來透過 Microsoft Store 完成交易的 UI。 這個方法提供選項,以在 Microsoft Store 中的單一清單所代表的大型產品目錄中,指定特定供應專案的其他詳細資料,包括在購買期間向使用者顯示的產品名稱。
重要
這個方法必須在 UI 執行緒上呼叫。
public:
virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId, StorePurchaseProperties ^ storePurchaseProperties) = RequestPurchaseAsync;
/// [Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId, StorePurchaseProperties const& storePurchaseProperties);
[Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId, StorePurchaseProperties storePurchaseProperties);
function requestPurchaseAsync(storeId, storePurchaseProperties)
Public Function RequestPurchaseAsync (storeId As String, storePurchaseProperties As StorePurchaseProperties) As IAsyncOperation(Of StorePurchaseResult)
參數
- storeId
-
String
Platform::String
winrt::hstring
您想要為目前使用者購買的應用程式或附加元件的市集識別碼。
- storePurchaseProperties
- StorePurchaseProperties
物件,指定購買要求的其他資訊,包括購買期間要向使用者顯示的產品名稱。
傳回
成功完成時,非同步作業會傳回 StorePurchaseResult 物件,該物件提供購買的狀態和錯誤資訊。
- 屬性
例外狀況
如果例外狀況的 ErrorCode 屬性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ,這表示未在 UI 執行緒上呼叫方法。 如果您在使用 傳統型橋接器 的桌面應用程式中呼叫這個方法,這也表示您未 < 設定 xref:Windows.Services.Store.StoreCoNtext?text=StoreCoNtext > 物件,以指定哪一個應用程式視窗是此方法所顯示模式對話方塊的擁有者視窗。 如需詳細資訊,請參閱這篇文章。
備註
應用程式或附加元件的市集識別碼可在合作夥伴中心取得,而StoreProduct 的 StoreId屬性會傳回代表應用程式或附加元件的StoreId屬性。
另請參閱
適用於
RequestPurchaseAsync(String)
public:
virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId) = RequestPurchaseAsync;
/// [Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId);
[Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId);
function requestPurchaseAsync(storeId)
Public Function RequestPurchaseAsync (storeId As String) As IAsyncOperation(Of StorePurchaseResult)
參數
- storeId
-
String
Platform::String
winrt::hstring
您想要為目前使用者購買的應用程式或附加元件的市集識別碼。
傳回
成功完成時,非同步作業會傳回 StorePurchaseResult 物件,該物件提供購買的狀態和錯誤資訊。
- 屬性
例外狀況
如果例外狀況的 ErrorCode 屬性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ,這表示未在 UI 執行緒上呼叫方法。 如果您在使用 傳統型橋接器 的桌面應用程式中呼叫這個方法,這也表示您未 < 設定 xref:Windows.Services.Store.StoreCoNtext?text=StoreCoNtext > 物件,以指定哪一個應用程式視窗是此方法所顯示模式對話方塊的擁有者視窗。 如需詳細資訊,請參閱這篇文章。
備註
如需使用此方法的詳細資訊,包括程式碼範例,請參閱 啟用應用程式內購買應用程式和附加元件。
應用程式或附加元件的市集識別碼可在合作夥伴中心取得,而StoreProduct 的 StoreId屬性會傳回代表應用程式或附加元件的StoreId屬性。