StoreContext Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece membros que você pode usar para acessar e gerenciar dados relacionados à Microsoft Store para o aplicativo atual. Por exemplo, você pode usar membros dessa classe para obter informações de listagem e licença da Microsoft Store para o aplicativo atual, comprar o aplicativo ou produtos atuais que são oferecidos pelo aplicativo ou baixar e instalar atualizações de pacote para o aplicativo.
Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do 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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
| API contract |
Windows.Services.Store.StoreContract (introduzida na v1.0)
|
Comentários
Observação
Essa classe e o restante do namespace Windows.Services.Store foi introduzido no Windows 10, versão 1607. Essa classe só pode ser usada em projetos direcionados ao Windows 10 Anniversary Edition (10.0; Build 14393) ou uma versão posterior no Visual Studio. Se o projeto for direcionado a uma versão anterior do Windows 10, você deverá usar o namespace Windows.ApplicationModel.Store em vez do namespace Windows.Services.Store . Para obter mais informações, consulte Compras no aplicativo e avaliações.
A classe StoreContext é o ponto de entrada main para o namespace Windows.Services.Store. Use membros dessa classe para executar tarefas como obter informações de listagem e licença da Microsoft Store para o aplicativo atual, comprar o aplicativo atual ou complementos que são oferecidos pelo aplicativo ou baixar e instalar atualizações de pacote para o aplicativo. Outras classes e tipos nesse namespace representam itens como complementos para o aplicativo, licenças para o aplicativo e seus complementos e informações de listagem da Microsoft Store para o aplicativo.
Para obter um objeto StoreContext, use um destes métodos estáticos:
GetDefault: use esse método em aplicativos de usuário único (ou seja, aplicativos executados somente no contexto do usuário que iniciou o aplicativo). Esse método obtém um objeto StoreContext que você pode usar para acessar e gerenciar dados relacionados à Microsoft Store para o usuário. A maioria dos aplicativos da Plataforma Universal do Windows (UWP) é um aplicativo de usuário único.
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();GetForUser: use esse método em aplicativos de vários usuários. Esse método obtém um objeto StoreContext que você pode usar para acessar e gerenciar dados relacionados à Microsoft Store para um usuário específico. Para obter mais informações sobre aplicativos multiusuários, consulte Introdução a aplicativos multiusuários.
var users = await Windows.System.User.FindAllAsync(); Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
Depois de ter um objeto StoreContext, você pode começar a chamar métodos para comprar um aplicativo ou complemento para o usuário atual e outras tarefas. Para obter mais informações, consulte os seguintes artigos:
- Compras no aplicativo e avaliações
- Obter informações do produto para aplicativos e complementos
- Obter informações de licença para apps e complementos
- Habilitar compras no aplicativo e complementos no aplicativo
- Habilitar compras de complementos consumíveis
- Implementar uma versão de avaliação do aplicativo
Você também pode usar um objeto StoreContext para baixar e instalar atualizações de pacote para o aplicativo. Para obter mais informações, consulte Baixar e instalar atualizações de pacote para seu aplicativo.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 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 |
Propriedades
| CanSilentlyDownloadStorePackageUpdates |
Obtém um valor que indica se as atualizações de pacote para o aplicativo atual podem ser baixadas sem exibir uma interface do usuário de notificação para o usuário. |
| User |
Obtém informações sobre o usuário associado ao objeto StoreContext atual em um aplicativo de vários usuários. |
Métodos
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
Adquire uma licença para o pacote de complemento DLC (conteúdo baixável) especificado para o aplicativo atual. |
| CanAcquireStoreLicenseAsync(String) |
Obtém um valor que indica se uma licença pode ser adquirida para o complemento DLC (conteúdo baixável) especificado do aplicativo atual para o usuário atual. |
| CanAcquireStoreLicenseForOptionalPackageAsync(Package) |
Obtém um valor que indica se uma licença pode ser adquirida para o pacote DLC (conteúdo baixável) especificado do aplicativo atual para o usuário atual. |
| DownloadAndInstallStorePackagesAsync(IIterable<String>) |
Baixa e instala os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual da Microsoft Store sem exibir uma caixa de diálogo de interface do usuário de notificação para o usuário. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
Obtém detalhes do produto store para o aplicativo ou complemento associado ao pacote especificado. |
| GetAppAndOptionalStorePackageUpdatesAsync() |
Obtém a coleção de pacotes para o aplicativo atual que têm atualizações disponíveis para download na Microsoft Store, incluindo pacotes opcionais para o aplicativo. |
| GetAppLicenseAsync() |
Obtém informações de licença para o aplicativo atual, incluindo licenças para complementos para o aplicativo atual. |
| GetAssociatedStoreProductsAsync(IIterable<String>) |
Obtém informações de listagem da Microsoft Store para os produtos que podem ser comprados de dentro do aplicativo atual. |
| GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>) |
Fornece membros que você pode usar para acessar e gerenciar dados relacionados à Microsoft Store para o aplicativo atual. Por exemplo, você pode usar membros dessa classe para obter informações de listagem e licença da Microsoft Store para o aplicativo atual, comprar o aplicativo ou produtos atuais que são oferecidos pelo aplicativo ou baixar e instalar atualizações de pacote para o aplicativo. Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow. |
| GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32) |
Obtém informações de listagem da Microsoft Store para os produtos que podem ser comprados de dentro do aplicativo atual. Esse método dá suporte à paginação para retornar os resultados. |
| GetAssociatedStoreQueueItemsAsync() |
Obtém informações sobre todos os pacotes novos ou atualizados que estão na fila de download e instalação do aplicativo atual. |
| GetConsumableBalanceRemainingAsync(String) |
Obtém o saldo restante para o complemento consumível especificado para o aplicativo atual. |
| GetCustomerCollectionsIdAsync(String, String) |
Recupera uma chave de ID da Microsoft Store que pode ser usada para consultar direitos de produto ou para consumir direitos de produto pertencentes ao usuário atual. |
| GetCustomerPurchaseIdAsync(String, String) |
Recupera uma chave de ID da Microsoft Store que pode ser usada para conceder direitos a produtos gratuitos em nome do usuário atual. |
| GetDefault() |
Obtém um objeto StoreContext que pode ser usado para acessar e gerenciar dados relacionados à Microsoft Store para o usuário atual no contexto do aplicativo atual. |
| GetForUser(User) |
Obtém um objeto StoreContext que pode ser usado para acessar e gerenciar dados relacionados à Microsoft Store para o usuário especificado no contexto do aplicativo atual. |
| GetStoreProductForCurrentAppAsync() |
Obtém informações de listagem da Microsoft Store para o aplicativo atual e fornece acesso a um método que você pode usar para comprar o aplicativo para o usuário atual. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>) |
Obtém informações de listagem da Microsoft Store para os produtos especificados associados ao aplicativo atual. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions) |
Obtém informações de listagem da Microsoft Store para os produtos especificados associados ao aplicativo atual, com a opção de usar um filtro para a consulta. |
| GetStoreQueueItemsAsync(IIterable<String>) |
Obtém informações sobre os pacotes novos ou atualizados especificados que estão na fila de download e instalação do aplicativo atual. |
| GetUserCollectionAsync(IIterable<String>) |
Obtém informações da Microsoft Store para os complementos do aplicativo atual para o qual o usuário comprou. |
| GetUserCollectionWithPagingAsync(IIterable<String>, UInt32) |
Obtém informações da Microsoft Store para os complementos do aplicativo atual para o qual o usuário comprou. Esse método dá suporte à paginação para retornar os resultados. |
| GetUserPurchaseHistoryAsync(IIterable<String>) |
Fornece membros que você pode usar para acessar e gerenciar dados relacionados à Microsoft Store para o aplicativo atual. Por exemplo, você pode usar membros dessa classe para obter informações de listagem e licença da Microsoft Store para o aplicativo atual, comprar o aplicativo ou produtos atuais que são oferecidos pelo aplicativo ou baixar e instalar atualizações de pacote para o aplicativo. Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Relata um complemento consumível para o aplicativo atual conforme atendido na Microsoft Store. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual da Microsoft Store. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual da Microsoft Store, com as opções de instalação especificadas. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tenta baixar e instalar as atualizações de pacote especificadas para o aplicativo atual da Microsoft Store. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tenta baixar as atualizações de pacote especificadas para o aplicativo atual da Microsoft Store. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestPurchaseAsync(String) |
Solicita a compra do aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
Solicita a compra do aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. Esse método fornece a opção de especificar detalhes adicionais para uma oferta específica dentro de um grande catálogo de produtos representados por uma única listagem na Microsoft Store, incluindo o nome do produto a ser exibido ao usuário durante a compra. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Fornece membros que você pode usar para acessar e gerenciar dados relacionados à Microsoft Store para o aplicativo atual. Por exemplo, você pode usar membros dessa classe para obter informações de listagem e licença da Microsoft Store para o aplicativo atual, comprar o aplicativo ou produtos atuais que são oferecidos pelo aplicativo ou baixar e instalar atualizações de pacote para o aplicativo. Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow. |
| RequestRateAndReviewAppAsync() |
Solicita que o usuário classifique e examine o aplicativo. Esse método exibirá a interface do usuário para o usuário selecionar uma classificação da Store e adicionar uma revisão opcional da Store para o produto. Importante Esse método deve ser chamado no thread da interface do usuário. |
| RequestUninstallStorePackageAsync(Package) |
Tenta desinstalar o pacote opcional especificado para o aplicativo atual. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação. |
| RequestUninstallStorePackageByStoreIdAsync(String) |
Tenta desinstalar o pacote DLC (conteúdo baixável) especificado para o aplicativo atual. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação. |
| SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>) |
Define a ordem na qual instalar os pacotes especificados na fila de download e instalação do aplicativo atual. |
| TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tenta baixar e instalar as atualizações de pacote especificadas para o aplicativo atual da Microsoft Store sem exibir uma interface do usuário de notificação para o usuário. |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Tenta baixar as atualizações de pacote especificadas para o aplicativo atual da Microsoft Store sem exibir uma interface do usuário de notificação para o usuário. |
| UninstallStorePackageAsync(Package) |
Desinstala o pacote opcional especificado para o aplicativo atual sem exibir uma caixa de diálogo de interface do usuário de notificação para o usuário. |
| UninstallStorePackageByStoreIdAsync(String) |
Desinstala o pacote DLC (conteúdo baixável) especificado para o aplicativo atual sem exibir uma caixa de diálogo de interface do usuário de notificação para o usuário. |
Eventos
| OfflineLicensesChanged |
Gerado quando o status da licença do aplicativo é alterado (por exemplo, o período de avaliação expirou ou o usuário comprou a versão completa do aplicativo). |