Compartir a través de


StoreContext Clase

Definición

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

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.

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

Se aplica a

Consulte también