StoreContext クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 StoreContextPublic NotInheritable Class StoreContext- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 Anniversary Edition (10.0.14393.0 で導入)
|
| API contract |
Windows.Services.Store.StoreContract (v1.0 で導入)
|
注釈
Note
このクラスと Windows.Services.Store 名前空間の残りの部分は、Windows 10 バージョン 1607 で導入されました。 このクラスは、Anniversary Edition (10.0; Windows 10対象のプロジェクトでのみ使用できます。Visual Studio のビルド 14393) 以降のリリース。 プロジェクトが以前のバージョンのWindows 10を対象とする場合は、Windows.Services.Store 名前空間ではなく Windows.ApplicationModel.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 ダイアログを表示せずに、Microsoft Store から現在のアプリの指定されたダウンロード可能コンテンツ (DLC) パッケージをダウンロードしてインストールします。 |
| 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>) |
現在のアプリに関連付けられている指定した製品の Microsoft Store 登録情報を取得します。 |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions) |
クエリにフィルターを使用するオプションを使用して、現在のアプリに関連付けられている指定された製品の 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>) |
Microsoft Store から、現在のアプリの指定したダウンロード可能コンテンツ (DLC) パッケージをダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
指定したインストール オプションを使用して、現在のアプリの指定したダウンロード可能コンテンツ (DLC) パッケージを Microsoft Store からダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Microsoft Store から現在のアプリの指定したパッケージ更新プログラムをダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Microsoft Store から現在のアプリの指定したパッケージ更新プログラムのダウンロードを試みます。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestPurchaseAsync(String) |
指定したアプリまたはアドオンの購入を要求し、Microsoft Store 経由でトランザクションを完了するために使用される UI を表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
指定したアプリまたはアドオンの購入を要求し、Microsoft Store 経由でトランザクションを完了するために使用される UI を表示します。 この方法では、購入時にユーザーに表示する製品名など、Microsoft Store の 1 つの一覧で表される製品の大規模なカタログ内の特定のオファーの追加の詳細を指定するオプションを提供します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestPurchaseByInAppOfferTokenAsync(String) |
現在のアプリの Microsoft Store 関連データにアクセスして管理するために使用できるメンバーを提供します。 たとえば、このクラスのメンバーを使用して、現在のアプリの Microsoft Store 登録情報とライセンス情報を取得したり、アプリによって提供されている現在のアプリまたは製品を購入したり、アプリのパッケージ更新プログラムをダウンロードしてインストールしたりできます。 デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。 |
| RequestRateAndReviewAppAsync() |
アプリの評価と確認をユーザーに要求します。 このメソッドは、ユーザーが [ストア] 評価を選択し、製品のオプションのストア レビューを追加するための UI を表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| 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 |
アプリのライセンスの状態が変更されたときに発生します (たとえば、試用期間の有効期限が切れているか、ユーザーがアプリのフル バージョンを購入した場合など)。 |