StoreContext Clase

Definición

Espacio de nombres:

Windows.Services.Store

Proporciona a los miembros que puedes usar para acceder a los datos relacionados con Microsoft Store y administrarlos para la aplicación actual. Por ejemplo, puedes usar miembros de esta clase para obtener información de licencia y descripción de Microsoft Store para la aplicación actual, comprar la aplicación actual o los productos que ofrece la aplicación, o descargar e instalar actualizaciones de paquetes para la aplicación.

En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de 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

Herencia

Object Platform::Object IInspectable StoreContext

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Services.Store.StoreContract (se introdujo en la versión v1.0)

Comentarios

Nota

Esta clase y el resto del espacio de nombres Windows.Services.Store se introdujo en Windows 10, versión 1607. Esta clase solo se puede usar en proyectos que tienen como destino Windows 10 Anniversary Edition (10.0; Compilación 14393) o una versión posterior en Visual Studio. Si el proyecto tiene como destino una versión anterior de Windows 10, debe usar el espacio de nombres Windows.ApplicationModel.Store en lugar del espacio de nombres Windows.Services.Store . Para obtener más información, consulta Pruebas y compras desde la aplicación.

La clase StoreContext es el punto de entrada principal del espacio de nombres Windows.Services.Store. Usa miembros de esta clase para realizar tareas como obtener información de licencia y descripción de Microsoft Store para la aplicación actual, comprar la aplicación actual o complementos que ofrece la aplicación, o descargar e instalar actualizaciones de paquetes para la aplicación. Otras clases y tipos de este espacio de nombres representan elementos como complementos para la aplicación, licencias para la aplicación y sus complementos, y información de descripción de Microsoft Store para la aplicación.

Para obtener un objeto StoreContext, use uno de estos métodos estáticos:

• GetDefault: use este método en aplicaciones de usuario único (es decir, aplicaciones que se ejecutan solo en el contexto del usuario que inició la aplicación). Este método obtiene un objeto StoreContext que puedes usar para acceder a los datos relacionados con Microsoft Store y administrarlos para el usuario. La mayoría de las aplicaciones para la Plataforma universal de Windows (UWP) son aplicaciones de usuario único.

  Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
  

• GetForUser: use este método en aplicaciones multiusuario. Este método obtiene un objeto StoreContext que puedes usar para acceder a los datos relacionados con Microsoft Store y administrarlos para un usuario específico. Para obtener más información sobre las aplicaciones multiusuario, consulta Introducción a las aplicaciones multiusuario.

  var users = await Windows.System.User.FindAllAsync();
  Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
  

Después de tener un objeto StoreContext, puedes empezar a llamar a métodos para comprar una aplicación o complemento para el usuario actual y otras tareas. Para más información, consulte los siguientes artículos.

• Pruebas y compras desde la aplicación
• Obtener información de producto para aplicaciones y complementos
• Obtener información de licencia para aplicaciones y complementos
• Habilitar compras desde la aplicación para aplicaciones y complementos
• Habilitar compras de complementos consumibles
• Implementar una versión de prueba de la aplicación

También puedes usar un objeto StoreContext para descargar e instalar actualizaciones de paquetes para la aplicación. Para obtener más información, consulta Descargar e instalar actualizaciones de paquetes para la aplicación.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
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

Propiedades

CanSilentlyDownloadStorePackageUpdates	Obtiene un valor que indica si se pueden descargar las actualizaciones de paquetes de la aplicación actual sin mostrar una interfaz de usuario de notificación al usuario.
User	Obtiene información sobre el usuario asociado al objeto StoreContext actual en una aplicación multiusuario.

Métodos

AcquireStoreLicenseForOptionalPackageAsync(Package)	Adquiere una licencia para el paquete de complemento de contenido descargable (DLC) especificado para la aplicación actual.
CanAcquireStoreLicenseAsync(String)	Obtiene un valor que indica si se puede adquirir una licencia para el complemento de contenido descargable (DLC) especificado de la aplicación actual para el usuario actual.
CanAcquireStoreLicenseForOptionalPackageAsync(Package)	Obtiene un valor que indica si se puede adquirir una licencia para el paquete de contenido descargable (DLC) especificado de la aplicación actual para el usuario actual.
DownloadAndInstallStorePackagesAsync(IIterable<String>)	Descarga e instala los paquetes de contenido descargable (DLC) especificados para la aplicación actual desde Microsoft Store sin mostrar un cuadro de diálogo de interfaz de usuario de notificación al usuario.
FindStoreProductForPackageAsync(IIterable<String>, Package)	Obtiene los detalles del producto de la Tienda para la aplicación o el complemento que está asociado al paquete especificado.
GetAppAndOptionalStorePackageUpdatesAsync()	Obtiene la colección de paquetes de la aplicación actual que tienen actualizaciones disponibles para su descarga desde Microsoft Store, incluidos los paquetes opcionales para la aplicación.
GetAppLicenseAsync()	Obtiene la información de licencia de la aplicación actual, incluidas las licencias de los complementos para la aplicación actual.
GetAssociatedStoreProductsAsync(IIterable<String>)	Obtiene información de descripción de Microsoft Store para los productos que se pueden comprar desde dentro de la aplicación actual.
GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>)	Proporciona a los miembros que puedes usar para acceder a los datos relacionados con Microsoft Store y administrarlos para la aplicación actual. Por ejemplo, puedes usar miembros de esta clase para obtener información de licencia y descripción de Microsoft Store para la aplicación actual, comprar la aplicación actual o los productos que ofrece la aplicación, o descargar e instalar actualizaciones de paquetes para la aplicación. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32)	Obtiene información de descripción de Microsoft Store para los productos que se pueden comprar desde dentro de la aplicación actual. Este método admite la paginación para devolver los resultados.
GetAssociatedStoreQueueItemsAsync()	Obtiene información sobre todos los paquetes nuevos o actualizados que se encuentran en la cola de descarga e instalación de la aplicación actual.
GetConsumableBalanceRemainingAsync(String)	Obtiene el saldo restante del complemento consumible especificado para la aplicación actual.
GetCustomerCollectionsIdAsync(String, String)	Recupera una clave de identificador de Microsoft Store que se puede usar para consultar los derechos del producto o para consumir derechos de producto que son propiedad del usuario actual.
GetCustomerPurchaseIdAsync(String, String)	Recupera una clave de identificador de Microsoft Store que se puede usar para conceder derechos para productos gratuitos en nombre del usuario actual.
GetDefault()	Obtiene un objeto StoreContext que se puede usar para acceder a los datos relacionados con Microsoft Store y administrarlos para el usuario actual en el contexto de la aplicación actual.
GetForUser(User)	Obtiene un objeto StoreContext que se puede usar para acceder a los datos relacionados con Microsoft Store y administrarlos para el usuario especificado en el contexto de la aplicación actual.
GetStoreProductForCurrentAppAsync()	Obtiene información de descripción de Microsoft Store para la aplicación actual y proporciona acceso a un método que puedes usar para comprar la aplicación para el usuario actual.
GetStoreProductsAsync(IIterable<String>, IIterable<String>)	Obtiene información de descripción de Microsoft Store para los productos especificados asociados a la aplicación actual.
GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions)	Obtiene información de descripción de Microsoft Store para los productos especificados asociados a la aplicación actual, con la opción de usar un filtro para la consulta.
GetStoreQueueItemsAsync(IIterable<String>)	Obtiene información sobre los paquetes nuevos o actualizados especificados que se encuentran en la cola de descarga e instalación de la aplicación actual.
GetUserCollectionAsync(IIterable<String>)	Obtiene información de Microsoft Store para los complementos de la aplicación actual para la que el usuario ha comprado.
GetUserCollectionWithPagingAsync(IIterable<String>, UInt32)	Obtiene información de Microsoft Store para los complementos de la aplicación actual para la que el usuario ha comprado. Este método admite la paginación para devolver los resultados.
GetUserPurchaseHistoryAsync(IIterable<String>)	Proporciona a los miembros que puedes usar para acceder a los datos relacionados con Microsoft Store y administrarlos para la aplicación actual. Por ejemplo, puedes usar miembros de esta clase para obtener información de licencia y descripción de Microsoft Store para la aplicación actual, comprar la aplicación actual o los productos que ofrece la aplicación, o descargar e instalar actualizaciones de paquetes para la aplicación. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
ReportConsumableFulfillmentAsync(String, UInt32, Guid)	Informa de un complemento consumible para la aplicación actual tal como se cumple en Microsoft Store.
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)	Intenta descargar e instalar los paquetes de contenido descargable (DLC) especificados para la aplicación actual desde Microsoft Store. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)	Intenta descargar e instalar los paquetes de contenido descargable (DLC) especificados para la aplicación actual de Microsoft Store, con las opciones de instalación especificadas. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Intenta descargar e instalar las actualizaciones de paquetes especificadas para la aplicación actual desde Microsoft Store. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Intenta descargar las actualizaciones de paquetes especificadas para la aplicación actual desde Microsoft Store. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestPurchaseAsync(String)	Solicita la compra de la aplicación o el complemento especificados y muestra la interfaz de usuario que se usa para completar la transacción a través de Microsoft Store. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestPurchaseAsync(String, StorePurchaseProperties)	Solicita la compra de la aplicación o el complemento especificados y muestra la interfaz de usuario que se usa para completar la transacción a través de Microsoft Store. Este método proporciona la opción de especificar detalles adicionales para una oferta específica dentro de un catálogo grande de productos representados por una sola descripción en Microsoft Store, incluido el nombre del producto para mostrar al usuario durante la compra. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestPurchaseByInAppOfferTokenAsync(String)	Proporciona a los miembros que puedes usar para acceder a los datos relacionados con Microsoft Store y administrarlos para la aplicación actual. Por ejemplo, puedes usar miembros de esta clase para obtener información de licencia y descripción de Microsoft Store para la aplicación actual, comprar la aplicación actual o los productos que ofrece la aplicación, o descargar e instalar actualizaciones de paquetes para la aplicación. En una aplicación de escritorio, antes de usar una instancia de esta clase de forma que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.
RequestRateAndReviewAppAsync()	Solicita al usuario que valore y revise la aplicación. Este método mostrará la interfaz de usuario para que el usuario seleccione una clasificación de la Tienda y agregue una revisión opcional de store para el producto. Importante Se debe llamar a este método en el subproceso de la interfaz de usuario.
RequestUninstallStorePackageAsync(Package)	Intenta desinstalar el paquete opcional especificado para la aplicación actual. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación.
RequestUninstallStorePackageByStoreIdAsync(String)	Intenta desinstalar el paquete de contenido descargable (DLC) especificado para la aplicación actual. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación.
SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>)	Establece el orden en el que se van a instalar los paquetes especificados en la cola de descarga e instalación de la aplicación actual.
TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Intenta descargar e instalar las actualizaciones de paquetes especificadas para la aplicación actual desde Microsoft Store sin mostrar una interfaz de usuario de notificación al usuario.
TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Intenta descargar las actualizaciones de paquetes especificadas para la aplicación actual desde Microsoft Store sin mostrar una interfaz de usuario de notificación al usuario.
UninstallStorePackageAsync(Package)	Desinstala el paquete opcional especificado para la aplicación actual sin mostrar un cuadro de diálogo de interfaz de usuario de notificación al usuario.
UninstallStorePackageByStoreIdAsync(String)	Desinstala el paquete de contenido descargable (DLC) especificado para la aplicación actual sin mostrar un cuadro de diálogo de interfaz de usuario de notificación al usuario.

Eventos

OfflineLicensesChanged

Se genera cuando cambia el estado de la licencia de la aplicación (por ejemplo, el período de prueba ha expirado o el usuario ha adquirido la versión completa de la aplicación).

Consulte también

• Pruebas y compras desde la aplicación
• Descargar e instalar actualizaciones de paquete para tu aplicación
• Muestra de la Tienda
• Visualización de objetos de la interfaz de usuario de WinRT que dependen de CoreWindow