StoreContext クラス

定義

名前空間:: Windows.Services.Store

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

現在のアプリのMicrosoft Store関連データにアクセスして管理するために使用できるメンバーを提供します。たとえば、このクラスのメンバーを使用して、現在のアプリMicrosoft Store登録情報とライセンス情報を取得したり、アプリによって提供されている現在のアプリまたは製品を購入したり、アプリのパッケージ更新プログラムをダウンロードしてインストールしたりできます。

デスクトップアプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウハンドルに関連付ける必要があります。詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。

public ref class StoreContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Services.Store.StoreContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StoreContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Services.Store.StoreContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StoreContext

Public NotInheritable Class StoreContext

継承: Object Platform::Object IInspectable StoreContext

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

要件	説明
デバイスファミリ	Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract	Windows.Services.Store.StoreContract (v1.0 で導入)

注釈

Note

このクラスとその他のWindows。Services.Store名前空間は、バージョン 1607 Windows 10で導入されました。このクラスは、Windows 10 Anniversary Edition (10.0; を対象とするプロジェクトでのみ使用できます。ビルド 14393) またはそれ以降のリリースVisual Studio。プロジェクトが以前のバージョンのWindows 10を対象とする場合は、Windowsを使用する必要があります。Windows ではなく、ApplicationModel.Store名前空間。Services.Store 名前空間。詳細については、「アプリ内購入と試用版の」を参照してください。

StoreContext クラスは、Windows のメインエントリポイントです。Services.Store名前空間。このクラスのメンバーを使用して、現在のアプリのMicrosoft Store登録情報とライセンス情報の取得、アプリによって提供されている現在のアプリまたはアドオンの購入、アプリのパッケージ更新プログラムのダウンロードとインストールなどのタスクを実行します。この名前空間のその他のクラスと型は、アプリのアドオン、アプリとそのアドオンのライセンス、アプリの一覧情報のMicrosoft Storeなどの項目を表します。

StoreContext オブジェクトを取得するには、次のいずれかの静的メソッドを使用します。

GetDefault: このメソッドは、シングルユーザーアプリ (つまり、アプリを起動したユーザーのコンテキストでのみ実行されるアプリ) で使用します。このメソッドは、ユーザーのMicrosoft Store関連データにアクセスして管理するために使用できる StoreContext オブジェクトを取得します。ほとんどのユニバーサル Windows プラットフォーム (UWP) アプリは、シングルユーザーアプリです。
```
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
```
GetForUser: マルチユーザーアプリでこのメソッドを使用します。このメソッドは、特定のユーザーのMicrosoft Store関連データにアクセスして管理するために使用できる StoreContext オブジェクトを取得します。マルチユーザーアプリの詳細については、「マルチユーザーアプリケーションの概要」を参照してください。
```
var users = await Windows.System.User.FindAllAsync();
Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
```

StoreContext オブジェクトを取得したら、メソッドの呼び出しを開始して、現在のユーザーや他のタスクのアプリまたはアドオンを購入できます。詳細については、次の記事を参照してください。

StoreContext オブジェクトを使用して、アプリのパッケージ更新プログラムをダウンロードしてインストールすることもできます。詳細については、「アプリのパッケージ更新プログラムをダウンロードしてインストールする」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	値の追加
1703	15063	FindStoreProductForPackageAsync
1803	17134	CanAcquireStoreLicenseAsync
1803	17134	CanAcquireStoreLicenseForOptionalPackageAsync
1803	17134	CanSilentlyDownloadStorePackageUpdates
1803	17134	DownloadAndInstallStorePackagesAsync
1803	17134	GetAssociatedStoreQueueItemsAsync
1803	17134	GetStoreProductsAsync(IEnumerable<String>,IEnumerable<String>,StoreProductOptions)
1803	17134	GetStoreQueueItemsAsync
1803	17134	RequestDownloadAndInstallStorePackagesAsync(IEnumerable<String>,StorePackageInstallOptions)
1803	17134	RequestUninstallStorePackageAsync
1803	17134	RequestUninstallStorePackageByStoreIdAsync
1803	17134	TrySilentDownloadAndInstallStorePackageUpdatesAsync
1803	17134	TrySilentDownloadStorePackageUpdatesAsync
1803	17134	UninstallStorePackageAsync
1803	17134	UninstallStorePackageByStoreIdAsync
1809	17763	RequestRateAndReviewAppAsync
1809	17763	SetInstallOrderForAssociatedStoreQueueItemsAsync

プロパティ

名前	説明
CanSilentlyDownloadStorePackageUpdates	ユーザーに通知 UI を表示せずに、現在のアプリのパッケージ更新プログラムをダウンロードできるかどうかを示す値を取得します。
User	マルチユーザーアプリの現在の StoreContext オブジェクトに関連付けられているユーザーに関する情報を取得します。

メソッド

名前	説明
AcquireStoreLicenseForOptionalPackageAsync(Package)	現在のアプリの指定されたダウンロードコンテンツ (DLC) アドオンパッケージのライセンスを取得します。
CanAcquireStoreLicenseAsync(String)	現在のユーザーの現在のアプリの指定したダウンロードコンテンツ (DLC) アドオンのライセンスを取得できるかどうかを示す値を取得します。
CanAcquireStoreLicenseForOptionalPackageAsync(Package)	現在のユーザーの現在のアプリの指定されたダウンロードコンテンツ (DLC) パッケージのライセンスを取得できるかどうかを示す値を取得します。
DownloadAndInstallStorePackagesAsync(IIterable<String>)	ユーザーに通知 UI ダイアログを表示せずに、現在のアプリの指定されたダウンロードコンテンツ (DLC) パッケージをMicrosoft Storeからダウンロードしてインストールします。
FindStoreProductForPackageAsync(IIterable<String>, Package)	指定したパッケージに関連付けられているアプリまたはアドオンのストア製品の詳細を取得します。
GetAppAndOptionalStorePackageUpdatesAsync()	アプリのオプションパッケージを含め、Microsoft Storeからダウンロードできる更新プログラムがある現在のアプリのパッケージのコレクションを取得します。
GetAppLicenseAsync()	現在のアプリのアドオンのライセンスを含む、現在のアプリのライセンス情報を取得します。
GetAssociatedStoreProductsAsync(IIterable<String>)	現在Microsoft Storeアプリ内から購入できる製品の一覧情報を取得します。
GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>)	現在のアプリのMicrosoft Store関連データにアクセスして管理するために使用できるメンバーを提供します。たとえば、このクラスのメンバーを使用して、現在のアプリMicrosoft Store登録情報とライセンス情報を取得したり、アプリによって提供されている現在のアプリまたは製品を購入したり、アプリのパッケージ更新プログラムをダウンロードしてインストールしたりできます。デスクトップアプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウハンドルに関連付ける必要があります。詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。
GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32)	現在Microsoft Storeアプリ内から購入できる製品の一覧情報を取得します。このメソッドは、結果を返すページングをサポートしています。
GetAssociatedStoreQueueItemsAsync()	現在のアプリのダウンロードおよびインストールキューに含まれるすべての新規または更新されたパッケージに関する情報を取得します。
GetConsumableBalanceRemainingAsync(String)	現在のアプリの指定された消耗品アドオンの残りの残高を取得します。
GetCustomerCollectionsIdAsync(String, String)	製品の権利を照会したり、現在のユーザーが所有する製品の権利を使用したりするために使用できるMicrosoft Store ID キーを取得します。
GetCustomerPurchaseIdAsync(String, String)	現在のユーザーに代わって無料製品の権利を付与するために使用できるMicrosoft Store ID キーを取得します。
GetDefault()	現在のアプリのコンテキストで現在のユーザーのMicrosoft Store関連データにアクセスして管理するために使用できるStoreContext オブジェクトを取得します。
GetForUser(User)	現在のアプリのコンテキストで指定したユーザーのMicrosoft Store関連データにアクセスして管理するために使用できるStoreContext オブジェクトを取得します。
GetStoreProductForCurrentAppAsync()	現在Microsoft Storeアプリの一覧情報を取得し、現在のユーザーのアプリの購入に使用できるメソッドへのアクセスを提供します。
GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions)	クエリMicrosoft Storeフィルターを使用するオプションを使用して、現在のアプリに関連付けられている指定した製品の一覧情報を取得します。
GetStoreProductsAsync(IIterable<String>, IIterable<String>)	現在Microsoft Storeアプリに関連付けられている指定した製品の一覧情報を取得します。
GetStoreQueueItemsAsync(IIterable<String>)	現在のアプリのダウンロードおよびインストールキューにある、指定された新規または更新されたパッケージに関する情報を取得します。
GetUserCollectionAsync(IIterable<String>)	ユーザー Microsoft Store購入した現在のアプリのアドオンの情報を取得します。
GetUserCollectionWithPagingAsync(IIterable<String>, UInt32)	ユーザー Microsoft Store購入した現在のアプリのアドオンの情報を取得します。このメソッドは、結果を返すページングをサポートしています。
GetUserPurchaseHistoryAsync(IIterable<String>)	現在のアプリのMicrosoft Store関連データにアクセスして管理するために使用できるメンバーを提供します。たとえば、このクラスのメンバーを使用して、現在のアプリMicrosoft Store登録情報とライセンス情報を取得したり、アプリによって提供されている現在のアプリまたは製品を購入したり、アプリのパッケージ更新プログラムをダウンロードしてインストールしたりできます。デスクトップアプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウハンドルに関連付ける必要があります。詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。
ReportConsumableFulfillmentAsync(String, UInt32, Guid)	Microsoft Storeで満たされた現在のアプリの消耗品アドオンを報告します。
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)	指定したインストールオプションを使用して、現在のアプリの指定したダウンロードコンテンツ (DLC) パッケージをMicrosoft Storeからダウンロードしてインストールしようとします。このメソッドには、操作のアクセス許可を要求する UI ダイアログも表示されます。 Important このメソッドは UI スレッドで呼び出す必要があります。
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)	Microsoft Storeから、現在のアプリの指定されたダウンロード可能コンテンツ (DLC) パッケージのダウンロードとインストールを試みます。このメソッドには、操作のアクセス許可を要求する UI ダイアログも表示されます。 Important このメソッドは UI スレッドで呼び出す必要があります。
RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Microsoft Storeから、現在のアプリの指定されたパッケージ更新プログラムのダウンロードとインストールを試みます。このメソッドには、操作のアクセス許可を要求する UI ダイアログも表示されます。 Important このメソッドは UI スレッドで呼び出す必要があります。
RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	現在のアプリの指定したパッケージ更新プログラムをMicrosoft Storeからダウンロードしようとします。このメソッドには、操作のアクセス許可を要求する UI ダイアログも表示されます。 Important このメソッドは UI スレッドで呼び出す必要があります。
RequestPurchaseAsync(String, StorePurchaseProperties)	指定したアプリまたはアドオンの購入を要求し、Microsoft Store経由でトランザクションを完了するために使用される UI を表示します。この方法では、購入時にユーザーに表示する製品名など、Microsoft Storeの 1 つの一覧で表される製品の大規模なカタログ内の特定のオファーの追加の詳細を指定するオプションを提供します。 Important このメソッドは UI スレッドで呼び出す必要があります。 Important アプリ内購入機能は、昇格されたアプリケーションではサポートされていません。
RequestPurchaseAsync(String)	指定したアプリまたはアドオンの購入を要求し、Microsoft Store経由でトランザクションを完了するために使用される UI を表示します。 Important このメソッドは UI スレッドで呼び出す必要があります。 Important アプリ内購入機能は、昇格されたアプリケーションではサポートされていません。
RequestPurchaseByInAppOfferTokenAsync(String)	現在のアプリのMicrosoft Store関連データにアクセスして管理するために使用できるメンバーを提供します。たとえば、このクラスのメンバーを使用して、現在のアプリMicrosoft Store登録情報とライセンス情報を取得したり、アプリによって提供されている現在のアプリまたは製品を購入したり、アプリのパッケージ更新プログラムをダウンロードしてインストールしたりできます。デスクトップアプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウハンドルに関連付ける必要があります。詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。
RequestRateAndReviewAppAsync()	アプリの評価とレビューをユーザーに要求します。このメソッドは、ユーザーがストアの評価を選択し、製品のオプションのストアレビューを追加するための UI を表示します。 Important このメソッドは UI スレッドで呼び出す必要があります。 Important アプリ内レートとレビュー機能は、昇格されたアプリケーションではサポートされていません。
RequestUninstallStorePackageAsync(Package)	現在のアプリの指定したオプションパッケージのアンインストールを試みます。このメソッドには、操作のアクセス許可を要求する UI ダイアログも表示されます。
RequestUninstallStorePackageByStoreIdAsync(String)	現在のアプリの指定したダウンロードコンテンツ (DLC) パッケージのアンインストールを試みます。このメソッドには、操作のアクセス許可を要求する UI ダイアログも表示されます。
SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>)	現在のアプリのダウンロードおよびインストールキューに指定したパッケージをインストールする順序を設定します。
TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	ユーザーに通知 UI を表示せずに、Microsoft Storeから現在のアプリの指定されたパッケージ更新プログラムをダウンロードしてインストールしようとします。
TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	ユーザーに通知 UI を表示せずに、現在のアプリの指定されたパッケージ更新プログラムをMicrosoft Storeからダウンロードしようとします。
UninstallStorePackageAsync(Package)	ユーザーに通知 UI ダイアログを表示せずに、現在のアプリの指定したオプションパッケージをアンインストールします。
UninstallStorePackageByStoreIdAsync(String)	ユーザーに通知 UI ダイアログを表示せずに、現在のアプリの指定されたダウンロードコンテンツ (DLC) パッケージをアンインストールします。

イベント

名前	説明
OfflineLicensesChanged	アプリのライセンスの状態が変更されたときに発生します (たとえば、試用期間の有効期限が切れている場合や、ユーザーがアプリの完全版を購入した場合など)。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?