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)
|
Комментарии
Note
Этот класс и остальная часть Windows. пространство имен Services.Store появилось в Windows 10 версии 1607. Этот класс можно использовать только в проектах, предназначенных для Windows 10 Anniversary Edition (10.0; Сборка 14393) или более поздней версии в Visual Studio. Если проект предназначен для более ранней версии Windows 10, необходимо использовать Windows. ApplicationModel.Store пространство имен вместо Windows. пространство имен Services.Store. Дополнительные сведения см. в разделе "Покупки в приложении" и пробные версии.
Класс 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 |
Возвращает значение, указывающее, можно ли скачать обновления пакетов для текущего приложения без отображения пользовательского интерфейса уведомления пользователю. |
| 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>, 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 сведения о списке и лицензии для текущего приложения, приобрести текущее приложение или продукты, предлагаемые приложением, или скачать и установить обновления пакетов для приложения. Перед использованием экземпляра этого класса в классическом приложении необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в разделе "Отображение объектов пользовательского интерфейса WinRT", зависящих от CoreWindow. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Сообщает потребляемую надстройку для текущего приложения, как выполнено в Microsoft Store. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Пытается скачать и установить указанные загружаемые пакеты содержимого (DLC) для текущего приложения из Microsoft Store с указанными параметрами установки. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Important Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Пытается скачать и установить указанные загружаемые пакеты содержимого (DLC) для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Important Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать и установить указанные обновления пакетов для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Important Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать указанные обновления пакета для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Important Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
Запрашивает покупку для указанного приложения или надстройки и отображает пользовательский интерфейс, используемый для завершения транзакции через Microsoft Store. Этот метод предоставляет возможность указать дополнительные сведения для конкретного предложения в большом каталоге продуктов, представленных одним списком в Microsoft Store, включая имя продукта, отображаемое пользователю во время покупки. Important Этот метод должен вызываться в потоке пользовательского интерфейса. Important Функции покупки в приложении не поддерживаются в приложениях с повышенными привилегиями. |
| RequestPurchaseAsync(String) |
Запрашивает покупку для указанного приложения или надстройки и отображает пользовательский интерфейс, используемый для завершения транзакции через Microsoft Store. Important Этот метод должен вызываться в потоке пользовательского интерфейса. Important Функции покупки в приложении не поддерживаются в приложениях с повышенными привилегиями. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Предоставляет участникам доступ к данным, связанным с Microsoft Store, и управлять ими для текущего приложения. Например, вы можете использовать члены этого класса, чтобы получить Microsoft Store сведения о списке и лицензии для текущего приложения, приобрести текущее приложение или продукты, предлагаемые приложением, или скачать и установить обновления пакетов для приложения. Перед использованием экземпляра этого класса в классическом приложении необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в разделе "Отображение объектов пользовательского интерфейса WinRT", зависящих от CoreWindow. |
| RequestRateAndReviewAppAsync() |
Запрашивает у пользователя скорость и просмотр приложения. Этот метод отобразит пользовательский интерфейс для пользователя, чтобы выбрать рейтинг Магазина и добавить необязательный обзор Магазина для продукта. Important Этот метод должен вызываться в потоке пользовательского интерфейса. Important Функции частоты и проверки в приложении не поддерживаются в приложениях с повышенными привилегиями. |
| RequestUninstallStorePackageAsync(Package) |
Пытается удалить указанный необязательный пакет для текущего приложения. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. |
| RequestUninstallStorePackageByStoreIdAsync(String) |
Пытается удалить указанный пакет загружаемого содержимого (DLC) для текущего приложения. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. |
| SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>) |
Задает порядок установки указанных пакетов в очереди загрузки и установки для текущего приложения. |
| TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать и установить указанные обновления пакетов для текущего приложения из Microsoft Store без отображения пользовательского интерфейса уведомления пользователю. |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Пытается скачать указанные обновления пакета для текущего приложения из Microsoft Store без отображения пользовательского интерфейса уведомления пользователю. |
| UninstallStorePackageAsync(Package) |
Удаляет указанный необязательный пакет для текущего приложения без отображения диалогового окна пользовательского интерфейса уведомления пользователю. |
| UninstallStorePackageByStoreIdAsync(String) |
Удаляет указанный пакет загружаемого содержимого (DLC) для текущего приложения без отображения диалогового окна пользовательского интерфейса уведомления пользователю. |
События
| Имя | Описание |
|---|---|
| OfflineLicensesChanged |
Вызывается при изменении состояния лицензии приложения (например, срок пробной версии приложения истек или пользователь приобрел полную версию приложения). |