StoreContext Classe

Definição

Namespace:: Windows.Services.Store

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.

Editar

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 Microsoft Store informações de listagem e licença 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 forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para saber mais e ver exemplos de código, confira Exibir objetos da 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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Requisitos	Description
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

Note

Esta classe e o resto do Windows. Services.Store namespace foi introduzido no Windows 10, versão 1607. Essa classe só pode ser usada em projetos destinados 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 Windows. ApplicationModel.Store namespace em vez do Windows. Services.Store namespace. Para obter mais informações, consulte compras e avaliações no aplicativo.

A classe StoreContext é o ponto de entrada principal para o Windows. Services.Store namespace. Use membros dessa classe para executar tarefas como obter informações de listagem e licença de 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 Microsoft Store informações de listagem 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) são aplicativos de usuário único.
```
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
```
GetForUser: use esse método em aplicativos multiusuários. Esse método obtém um objeto StoreContext que você pode usar para acessar e gerenciar dados relacionados a 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ões

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	DesinstallStorePackageAsync
1803	17134	UninstallStorePackageByStoreIdAsync
1809	17763	RequestRateAndReviewAppAsync
1809	17763	SetInstallOrderForAssociatedStoreQueueItemsAsync

Propriedades

Nome	Description
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

Nome	Description
AcquireStoreLicenseForOptionalPackageAsync(Package)	Adquire uma licença para o pacote de complemento DLC (conteúdo para download) 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 para download) 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 de DLC (conteúdo para download) especificados para o aplicativo atual do 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 os 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 do 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 Microsoft Store informações de listagem para os produtos que podem ser comprados no 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 Microsoft Store informações de listagem e licença 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 forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para saber mais e ver exemplos de código, confira Exibir objetos da interface do usuário do WinRT que dependem do CoreWindow.
GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32)	Obtém Microsoft Store informações de listagem para os produtos que podem ser comprados no 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 do complemento consumível especificado para o aplicativo atual.
GetCustomerCollectionsIdAsync(String, String)	Recupera uma chave de ID Microsoft Store que pode ser usada para consultar direitos de produto ou para consumir direitos de produto que pertencem ao usuário atual.
GetCustomerPurchaseIdAsync(String, String)	Recupera uma chave de ID de Microsoft Store que pode ser usada para conceder direitos para 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 Microsoft Store informações de listagem 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>, StoreProductOptions)	Obtém Microsoft Store informações de listagem para os produtos especificados associados ao aplicativo atual, com a opção de usar um filtro para a consulta.
GetStoreProductsAsync(IIterable<String>, IIterable<String>)	Obtém Microsoft Store informações de listagem para os produtos especificados associados ao aplicativo atual.
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 Microsoft Store informações para os complementos do aplicativo atual para o qual o usuário comprou.
GetUserCollectionWithPagingAsync(IIterable<String>, UInt32)	Obtém Microsoft Store informações 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 Microsoft Store informações de listagem e licença 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 forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para saber mais e ver exemplos de código, confira Exibir objetos da 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 no Microsoft Store.
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)	Tenta baixar e instalar os pacotes DLC (conteúdo para download) especificados para o aplicativo atual do Microsoft Store, com as opções de instalação especificadas. Esse método também exibe uma caixa de diálogo da 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>)	Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual do Microsoft Store. Esse método também exibe uma caixa de diálogo da 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 do Microsoft Store. Esse método também exibe uma caixa de diálogo da 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 do Microsoft Store. Esse método também exibe uma caixa de diálogo da 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, StorePurchaseProperties)	Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio do Microsoft Store. Esse método fornece a opção de especificar detalhes adicionais para uma oferta específica em um catálogo grande de produtos que são representados por uma única listagem no 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. Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados.
RequestPurchaseAsync(String)	Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio do Microsoft Store. Importante Esse método deve ser chamado no thread da interface do usuário. Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados.
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 Microsoft Store informações de listagem e licença 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 forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para saber mais e ver exemplos de código, confira Exibir objetos da 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. Importante Não há suporte para a funcionalidade de avaliação e taxa no aplicativo em aplicativos elevados.
RequestUninstallStorePackageAsync(Package)	Tenta desinstalar o pacote opcional especificado para o aplicativo atual. Esse método também exibe uma caixa de diálogo da interface do usuário que solicita permissão para a operação.
RequestUninstallStorePackageByStoreIdAsync(String)	Tenta desinstalar o pacote DLC (conteúdo para download) especificado para o aplicativo atual. Esse método também exibe uma caixa de diálogo da 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 do 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 do 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 para download) 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

Nome	Description
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

Comentários

Esta página foi útil?