Compartilhar via


StoreContext Classe

Definição

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 StoreContext
Public NotInheritable Class StoreContext
Herança
Object Platform::Object IInspectable StoreContext
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:

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).

Aplica-se a

Confira também