StoreContext Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет участников, которые можно использовать для доступа к данным, связанным с Microsoft Store, и управления ими для текущего приложения. Например, участники этого класса можно использовать для получения сведений о списке и лицензии в Microsoft Store для текущего приложения, приобретения текущего приложения или продуктов, предлагаемых приложением, а также для скачивания и установки обновлений пакета для приложения.
В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.
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; Сборка 14393) или более поздней версии в Visual Studio. Если проект предназначен для более ранней версии Windows 10, необходимо использовать пространство имен Windows.ApplicationModel.Store вместо пространства имен Windows.Services.Store . Подробнее см. в разделе Покупки из приложения и пробные версии.
Класс StoreContext является main точкой входа в пространство имен Windows.Services.Store. Используйте членов этого класса для выполнения таких задач, как получение сведений о списке и лицензии в Microsoft Store для текущего приложения, приобретение текущего приложения или надстроек, предлагаемых приложением, а также скачивание и установка обновлений пакета для приложения. Другие классы и типы в этом пространстве имен представляют такие элементы, как надстройки для приложения, лицензии для приложения и его надстроек, а также сведения о списке приложений в Microsoft Store.
Чтобы получить объект StoreContext, используйте один из следующих статических методов:
GetDefault: используйте этот метод в однопользовательских приложениях (т. е. в приложениях, которые выполняются только в контексте пользователя, который запустил приложение). Этот метод получает объект StoreContext, который можно использовать для доступа к данным, связанным с Microsoft Store, и управления ими для пользователя. Большинство приложений 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 |
Возвращает значение, указывающее, можно ли скачать обновления пакета для текущего приложения без отображения пользовательского интерфейса уведомления для пользователя. |
| User |
Возвращает сведения о пользователе, связанном с текущим объектом StoreContext в многопользовательском приложении. |
Методы
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
Получает лицензию на указанный пакет надстройки с загружаемым контентом (DLC) для текущего приложения. |
| CanAcquireStoreLicenseAsync(String) |
Возвращает значение, указывающее, можно ли получить лицензию для указанной надстройки с загружаемым контентом (DLC) текущего приложения для текущего пользователя. |
| CanAcquireStoreLicenseForOptionalPackageAsync(Package) |
Возвращает значение, указывающее, можно ли получить лицензию для указанного пакета загружаемого содержимого (DLC) текущего приложения для текущего пользователя. |
| DownloadAndInstallStorePackagesAsync(IIterable<String>) |
Скачивает и устанавливает указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store без отображения пользователю диалогового окна пользовательского интерфейса уведомлений. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
Возвращает сведения о продукте Store для приложения или надстройки, связанных с указанным пакетом. |
| GetAppAndOptionalStorePackageUpdatesAsync() |
Возвращает коллекцию пакетов для текущего приложения, обновления которых доступны для скачивания из Microsoft Store, включая необязательные пакеты для приложения. |
| GetAppLicenseAsync() |
Получает сведения о лицензии для текущего приложения, включая лицензии на надстройки для текущего приложения. |
| GetAssociatedStoreProductsAsync(IIterable<String>) |
Получает сведения о продуктах, которые можно приобрести в текущем приложении в Microsoft Store. |
| GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>) |
Предоставляет участников, которые можно использовать для доступа к данным, связанным с Microsoft Store, и управления ими для текущего приложения. Например, участники этого класса можно использовать для получения сведений о списке и лицензии в Microsoft Store для текущего приложения, приобретения текущего приложения или продуктов, предлагаемых приложением, а также для скачивания и установки обновлений пакета для приложения. В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow. |
| 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 для текущего приложения, приобретения текущего приложения или продуктов, предлагаемых приложением, а также для скачивания и установки обновлений пакета для приложения. В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Сообщает о потребляемой надстройке для текущего приложения, выполненной в Microsoft Store. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store с указанными параметрами установки. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать и установить указанные обновления пакета для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать указанные обновления пакета для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestPurchaseAsync(String) |
Запрашивает покупку для указанного приложения или надстройки и отображает пользовательский интерфейс, используемый для завершения транзакции через Microsoft Store. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
Запрашивает покупку для указанного приложения или надстройки и отображает пользовательский интерфейс, используемый для завершения транзакции через Microsoft Store. Этот метод позволяет указать дополнительные сведения о конкретном предложении в большом каталоге продуктов, представленных одним описанием в Microsoft Store, включая название продукта, которое будет отображаться пользователю во время покупки. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Предоставляет участников, которые можно использовать для доступа к данным, связанным с Microsoft Store, и управления ими для текущего приложения. Например, участники этого класса можно использовать для получения сведений о списке и лицензии в Microsoft Store для текущего приложения, приобретения текущего приложения или продуктов, предлагаемых приложением, а также для скачивания и установки обновлений пакета для приложения. В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow. |
| RequestRateAndReviewAppAsync() |
Запрашивает у пользователя оценку и просмотр приложения. Этот метод отображает пользовательский интерфейс для выбора оценки Магазина и добавления необязательной проверки Магазина для продукта. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestUninstallStorePackageAsync(Package) |
Пытается удалить указанный необязательный пакет для текущего приложения. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. |
| RequestUninstallStorePackageByStoreIdAsync(String) |
Пытается удалить указанный пакет загружаемого содержимого (DLC) для текущего приложения. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. |
| SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>) |
Задает порядок установки указанных пакетов в очереди загрузки и установки для текущего приложения. |
| TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать и установить указанные обновления пакета для текущего приложения из Microsoft Store без отображения пользовательского интерфейса уведомления для пользователя. |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать указанные обновления пакета для текущего приложения из Microsoft Store без отображения пользовательского интерфейса уведомления для пользователя. |
| UninstallStorePackageAsync(Package) |
Удаляет указанный необязательный пакет для текущего приложения без отображения пользователю диалогового окна пользовательского интерфейса уведомлений. |
| UninstallStorePackageByStoreIdAsync(String) |
Удаляет указанный пакет загружаемого содержимого (DLC) для текущего приложения без отображения пользователю диалогового окна пользовательского интерфейса уведомлений. |
События
| OfflineLicensesChanged |
Возникает при изменении состояния лицензии приложения (например, истек пробный период или пользователь приобрел полную версию приложения). |