Поделиться через


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 StoreContext
Public NotInheritable Class StoreContext
Наследование
Object Platform::Object IInspectable 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

Возникает при изменении состояния лицензии приложения (например, истек пробный период или пользователь приобрел полную версию приложения).

Применяется к

См. также раздел