Condividi tramite


StoreContext Classe

Definizione

Fornisce i membri che è possibile usare per accedere e gestire i dati correlati a Microsoft Store per l'app corrente. Ad esempio, puoi usare i membri di questa classe per ottenere informazioni sulla presentazione e sulla licenza di Microsoft Store per l'app corrente, acquistare l'app o i prodotti correnti offerti dall'app o scaricare e installare gli aggiornamenti dei pacchetti per l'app.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da 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
Ereditarietà
Object Platform::Object IInspectable StoreContext
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract
Windows.Services.Store.StoreContract (è stato introdotto in v1.0)

Commenti

Nota

Questa classe e il resto dello spazio dei nomi Windows.Services.Store sono stati introdotti in Windows 10 versione 1607. Questa classe può essere usata solo nei progetti destinati Windows 10 Anniversary Edition (10.0; Build 14393) o versione successiva in Visual Studio. Se il progetto è destinato a una versione precedente di Windows 10, è necessario usare lo spazio dei nomi Windows.ApplicationModel.Store anziché lo spazio dei nomi Windows.Services.Store. Per altre informazioni, vedi Acquisti in-app e versioni di prova.

La classe StoreContext è il punto di ingresso principale dello spazio dei nomi Windows.Services.Store. Usa i membri di questa classe per eseguire attività come ottenere informazioni sulla presentazione e sulla licenza di Microsoft Store per l'app corrente, acquistare l'app o i componenti aggiuntivi correnti offerti dall'app o scaricare e installare gli aggiornamenti dei pacchetti per l'app. Altre classi e tipi in questo spazio dei nomi rappresentano elementi come componenti aggiuntivi per l'app, licenze per l'app e i relativi componenti aggiuntivi e informazioni sulla presentazione in Microsoft Store per l'app.

Per ottenere un oggetto StoreContext, usare uno dei metodi statici seguenti:

  • GetDefault: usare questo metodo nelle app a utente singolo, ovvero le app eseguite solo nel contesto dell'utente che ha avviato l'app. Questo metodo ottiene un oggetto StoreContext che è possibile usare per accedere e gestire i dati correlati a Microsoft Store per l'utente. Quasi tutte le app UWP (Universal Windows Platform) sono app per un singolo utente.

    Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
    
  • GetForUser: usare questo metodo nelle app multiutente. Questo metodo ottiene un oggetto StoreContext che è possibile usare per accedere e gestire i dati correlati a Microsoft Store per un utente specifico. Per altre informazioni sulle app multiutente, vedere Introduzione alle applicazioni multiutente.

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

Dopo aver creato un oggetto StoreContext, puoi iniziare a chiamare i metodi per acquistare un'app o un componente aggiuntivo per l'utente corrente e altre attività. Per altre informazioni, vedere gli articoli seguenti:

Puoi anche usare un oggetto StoreContext per scaricare e installare gli aggiornamenti dei pacchetti per l'app. Per altre informazioni, vedere Scaricare e installare gli aggiornamenti dei pacchetti per l'app.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
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

Proprietà

CanSilentlyDownloadStorePackageUpdates

Ottiene un valore che indica se gli aggiornamenti dei pacchetti per l'app corrente possono essere scaricati senza visualizzare un'interfaccia utente di notifica all'utente.

User

Ottiene informazioni sull'utente associato all'oggetto StoreContext corrente in un'app multiutente.

Metodi

AcquireStoreLicenseForOptionalPackageAsync(Package)

Acquisisce una licenza per il pacchetto aggiuntivo DLC (Downloadable Content) specificato per l'app corrente.

CanAcquireStoreLicenseAsync(String)

Ottiene un valore che indica se è possibile acquisire una licenza per il componente aggiuntivo DLC (Downloadable Content) specificato dell'app corrente per l'utente corrente.

CanAcquireStoreLicenseForOptionalPackageAsync(Package)

Ottiene un valore che indica se è possibile acquisire una licenza per il pacchetto DLC (Downloadable Content) specificato dell'app corrente per l'utente corrente.

DownloadAndInstallStorePackagesAsync(IIterable<String>)

Scarica e installa i pacchetti DLC (Downloadable Content) specificati per l'app corrente da Microsoft Store senza visualizzare una finestra di dialogo dell'interfaccia utente di notifica all'utente.

FindStoreProductForPackageAsync(IIterable<String>, Package)

Ottiene i dettagli del prodotto dello Store per l'app o il componente aggiuntivo associato al pacchetto specificato.

GetAppAndOptionalStorePackageUpdatesAsync()

Ottiene la raccolta di pacchetti per l'app corrente con aggiornamenti disponibili per il download da Microsoft Store, inclusi i pacchetti facoltativi per l'app.

GetAppLicenseAsync()

Ottiene le informazioni sulla licenza per l'app corrente, incluse le licenze per i componenti aggiuntivi per l'app corrente.

GetAssociatedStoreProductsAsync(IIterable<String>)

Ottiene le informazioni sulla presentazione in Microsoft Store per i prodotti che possono essere acquistati dall'interno dell'app corrente.

GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>)

Fornisce i membri che è possibile usare per accedere e gestire i dati correlati a Microsoft Store per l'app corrente. Ad esempio, puoi usare i membri di questa classe per ottenere informazioni sulla presentazione e sulla licenza di Microsoft Store per l'app corrente, acquistare l'app o i prodotti correnti offerti dall'app o scaricare e installare gli aggiornamenti dei pacchetti per l'app.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32)

Ottiene le informazioni sulla presentazione in Microsoft Store per i prodotti che possono essere acquistati dall'interno dell'app corrente. Questo metodo supporta il paging per restituire i risultati.

GetAssociatedStoreQueueItemsAsync()

Ottiene informazioni su tutti i pacchetti nuovi o aggiornati presenti nella coda di download e installazione per l'app corrente.

GetConsumableBalanceRemainingAsync(String)

Ottiene il saldo rimanente per il componente aggiuntivo di consumo specificato per l'app corrente.

GetCustomerCollectionsIdAsync(String, String)

Recupera una chiave ID di Microsoft Store che può essere usata per eseguire query sui diritti del prodotto o per utilizzare i diritti del prodotto di proprietà dell'utente corrente.

GetCustomerPurchaseIdAsync(String, String)

Recupera una chiave ID di Microsoft Store che può essere usata per concedere diritti per i prodotti gratuiti per conto dell'utente corrente.

GetDefault()

Ottiene un oggetto StoreContext che può essere utilizzato per accedere e gestire i dati correlati a Microsoft Store per l'utente corrente nel contesto dell'app corrente.

GetForUser(User)

Ottiene un oggetto StoreContext che può essere utilizzato per accedere e gestire i dati correlati a Microsoft Store per l'utente specificato nel contesto dell'app corrente.

GetStoreProductForCurrentAppAsync()

Ottiene le informazioni sulla presentazione in Microsoft Store per l'app corrente e fornisce l'accesso a un metodo che puoi usare per acquistare l'app per l'utente corrente.

GetStoreProductsAsync(IIterable<String>, IIterable<String>)

Ottiene le informazioni sulla presentazione in Microsoft Store per i prodotti specificati associati all'app corrente.

GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions)

Ottiene le informazioni sulla presentazione in Microsoft Store per i prodotti specificati associati all'app corrente, con l'opzione per usare un filtro per la query.

GetStoreQueueItemsAsync(IIterable<String>)

Ottiene informazioni sui pacchetti nuovi o aggiornati specificati presenti nella coda di download e installazione per l'app corrente.

GetUserCollectionAsync(IIterable<String>)

Ottiene le informazioni di Microsoft Store per i componenti aggiuntivi dell'app corrente per cui l'utente ha acquistato.

GetUserCollectionWithPagingAsync(IIterable<String>, UInt32)

Ottiene le informazioni di Microsoft Store per i componenti aggiuntivi dell'app corrente per cui l'utente ha acquistato. Questo metodo supporta il paging per restituire i risultati.

GetUserPurchaseHistoryAsync(IIterable<String>)

Fornisce i membri che è possibile usare per accedere e gestire i dati correlati a Microsoft Store per l'app corrente. Ad esempio, puoi usare i membri di questa classe per ottenere informazioni sulla presentazione e sulla licenza di Microsoft Store per l'app corrente, acquistare l'app o i prodotti correnti offerti dall'app o scaricare e installare gli aggiornamenti dei pacchetti per l'app.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

ReportConsumableFulfillmentAsync(String, UInt32, Guid)

Segnala un componente aggiuntivo di consumo per l'app corrente come evaso in Microsoft Store.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

Tenta di scaricare e installare i pacchetti DLC (Downloadable Content) specificati per l'app corrente da Microsoft Store. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Tenta di scaricare e installare i pacchetti DLC (Downloadable Content) specificati per l'app corrente da Microsoft Store, con le opzioni di installazione specificate. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Tenta di scaricare e installare gli aggiornamenti del pacchetto specificati per l'app corrente da Microsoft Store. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Tenta di scaricare gli aggiornamenti del pacchetto specificati per l'app corrente da Microsoft Store. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestPurchaseAsync(String)

Richiede l'acquisto per l'app o il componente aggiuntivo specificato e visualizza l'interfaccia utente usata per completare la transazione tramite Microsoft Store.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestPurchaseAsync(String, StorePurchaseProperties)

Richiede l'acquisto per l'app o il componente aggiuntivo specificato e visualizza l'interfaccia utente usata per completare la transazione tramite Microsoft Store. Questo metodo offre la possibilità di specificare dettagli aggiuntivi per un'offerta specifica all'interno di un ampio catalogo di prodotti rappresentati da una singola inserzione in Microsoft Store, incluso il nome del prodotto da visualizzare all'utente durante l'acquisto.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestPurchaseByInAppOfferTokenAsync(String)

Fornisce i membri che è possibile usare per accedere e gestire i dati correlati a Microsoft Store per l'app corrente. Ad esempio, puoi usare i membri di questa classe per ottenere informazioni sulla presentazione e sulla licenza di Microsoft Store per l'app corrente, acquistare l'app o i prodotti correnti offerti dall'app o scaricare e installare gli aggiornamenti dei pacchetti per l'app.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

RequestRateAndReviewAppAsync()

Richiede all'utente di valutare ed esaminare l'app. Questo metodo visualizzerà l'interfaccia utente per l'utente per selezionare una valutazione dello Store e aggiungere una revisione facoltativa dello Store per il prodotto.

Importante

Questo metodo deve essere chiamato nel thread dell'interfaccia utente.

RequestUninstallStorePackageAsync(Package)

Tenta di disinstallare il pacchetto facoltativo specificato per l'app corrente. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.

RequestUninstallStorePackageByStoreIdAsync(String)

Tenta di disinstallare il pacchetto DLC (Downloadable Content) specificato per l'app corrente. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.

SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>)

Imposta l'ordine in cui installare i pacchetti specificati nella coda di download e installazione per l'app corrente.

TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Tenta di scaricare e installare gli aggiornamenti del pacchetto specificati per l'app corrente da Microsoft Store senza visualizzare un'interfaccia utente di notifica all'utente.

TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Tenta di scaricare gli aggiornamenti del pacchetto specificati per l'app corrente da Microsoft Store senza visualizzare un'interfaccia utente di notifica all'utente.

UninstallStorePackageAsync(Package)

Disinstalla il pacchetto facoltativo specificato per l'app corrente senza visualizzare una finestra di dialogo dell'interfaccia utente di notifica all'utente.

UninstallStorePackageByStoreIdAsync(String)

Disinstalla il pacchetto DLC (Downloadable Content) specificato per l'app corrente senza visualizzare una finestra di dialogo dell'interfaccia utente di notifica all'utente.

Eventi

OfflineLicensesChanged

Generato quando lo stato della licenza dell'app cambia (ad esempio, il periodo di valutazione è scaduto o l'utente ha acquistato la versione completa dell'app).

Si applica a

Vedi anche