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 引進)
|
備註
注意
這個類別和Windows.Services.Store 命名空間的其餘部分是在 Windows 10 1607 版中引進。 這個類別只能用於以Windows 10 Anniversary Edition (10.0 為目標的專案;Visual Studio 中的組建 14393) 或更新版本。 如果您的專案是以舊版Windows 10為目標，您必須使用Windows.ApplicationModel.Store命名空間，而不是Windows.Services.Store命名空間。 如需詳細資訊，請參閱 App 內購買和試用版。
StoreCoNtext 類別是 Windows.Services.Store 命名空間的主要進入點。 使用此類別的成員來執行工作，例如取得目前應用程式的 Microsoft Store 清單和授權資訊、購買應用程式所提供的目前應用程式或附加元件，或下載並安裝應用程式的套件更新。 此命名空間中的其他類別和類型代表應用程式附加元件、應用程式授權及其附加元件，以及應用程式的 Microsoft Store 清單資訊等專案。
若要取得 StoreCoNtext 物件，請使用下列其中一個靜態方法：
GetDefault：在單一使用者應用程式中使用此方法 (，也就是只在啟動應用程式的使用者內容中執行的應用程式) 。 這個方法會取得 StoreCoNtext 物件，您可以用來存取及管理使用者的 Microsoft Store 相關資料。 大多數通用 Windows 平台 (UWP) 應用程式都是單一使用者應用程式。
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();GetForUser：在多使用者應用程式中使用此方法。 這個方法會取得 StoreCoNtext 物件，您可以用來存取及管理特定使用者的 Microsoft Store 相關資料。 如需多使用者應用程式的詳細資訊，請參閱 多使用者應用程式簡介。
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>) |
從 Microsoft Store 下載並安裝目前應用程式的指定可下載內容 (DLC) 套件，而不向使用者顯示通知 UI 對話方塊。 |
| 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 識別碼金鑰，可用來查詢產品權利，或取用目前使用者所擁有的產品權利。 |
| GetCustomerPurchaseIdAsync(String, String) |
擷取 Microsoft Store 識別碼金鑰，可用來代表目前使用者授與免費產品的權利。 |
| GetDefault() |
取得 StoreCoNtext 物件，可用來存取和管理目前應用程式內容中目前使用者的 Microsoft Store 相關資料。 |
| GetForUser(User) |
取得 StoreCoNtext 物件，可用來存取和管理目前應用程式內容中指定使用者的 Microsoft Store 相關資料。 |
| 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) |
嘗試從 Microsoft Store 下載並安裝指定的可下載內容 (DLC) 套件，以及指定的安裝選項。 這個方法也會顯示要求作業許可權的 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 中的單一清單所代表的大型產品目錄中，指定特定供應專案的其他詳細資料，包括在購買期間向使用者顯示的產品名稱。 重要 這個方法必須在 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>) |
嘗試從 Microsoft Store 下載並安裝目前應用程式的指定套件更新，而不向使用者顯示通知 UI。 |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
嘗試從 Microsoft Store 下載目前應用程式的指定套件更新，而不向使用者顯示通知 UI。 |
| UninstallStorePackageAsync(Package) |
卸載目前應用程式的指定選擇性套件，而不向使用者顯示通知 UI 對話方塊。 |
| UninstallStorePackageByStoreIdAsync(String) |
卸載目前應用程式的指定可下載內容 (DLC) 套件，而不向使用者顯示通知 UI 對話方塊。 |
事件
| OfflineLicensesChanged |
例如，當應用程式授權的狀態變更 (時引發，例如試用版期間已過期，或使用者已購買應用程式的完整版本) 。 |