StoreContext Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 StoreContextPublic NotInheritable Class StoreContext- Ereditarietà
- 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:
- Acquisti in-app e versioni di prova
- Ottenere info sul prodotto per le app e i componenti aggiuntivi
- Ottenere info sulla licenza per le app e i componenti aggiuntivi
- Abilitare gli acquisti in-app di app e componenti aggiuntivi
- Abilitare gli acquisti di componenti aggiuntivi di consumo
- Implementare una versione di prova dell'app
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). |