CurrentApp Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.ApplicationModel.Store

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.

Modifica

Definisce i metodi e le proprietà che è possibile usare per ottenere le informazioni sulle licenze e elencare l'app corrente ed eseguire acquisti di prodotti in-app.

Nota

La classe CurrentApp e gli altri tipi nello spazio dei nomi Windows.ApplicationModel.Store non vengono più aggiornati con nuove funzionalità. Se il progetto è destinato Windows 10 Anniversary Edition (10,0; Build 14393) o una versione successiva in Visual Studio (ovvero, si intende indirizzare Windows 10, versione 1607 o successiva), è consigliabile usare invece lo spazio dei nomi Windows.Services.Store. Per altre informazioni, vedi Acquisti in-app e versioni di prova. La classe CurrentApp non è supportata nelle applicazioni desktop di Windows che usano la Desktop Bridge o nelle app o nei giochi che usano una sandbox di sviluppo nel Centro per i partner( ad esempio, questo è il caso di qualsiasi gioco che si integra con Xbox Live). Questi prodotti devono usare lo spazio dei nomi Windows.Services.Store per implementare acquisti e versioni di valutazione in-app.

public ref class CurrentApp abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentApp final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class CurrentApp

Public Class CurrentApp

Ereditarietà: Object Platform::Object IInspectable CurrentApp

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Questo oggetto ottiene i dati da Microsoft Store, quindi è necessario disporre di un account sviluppatore e l'app deve essere pubblicata in Microsoft Store. Prima di inviare a Microsoft Store, è possibile testare il codice con una versione simulata di questa classe (lo stato viene inizializzato da un file XML). Vedere CurrentAppSimulator.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1511	10586	GetCustomerCollectionsIdAsync
1511	10586	GetCustomerPurchaseIdAsync

Proprietà

AppId	Ottiene il GUID generato da Windows Store quando l'app è stata certificata per la presentazione in Windows Store. Nota Dopo che l'app si trova in Windows Store, gli aggiornamenti delle app future o le modifiche apportate alla descrizione dell'app non generano una modifica all'oggetto CurrentApp.AppId.
LicenseInformation	Ottiene i metadati della licenza per l'app corrente.
LinkUri	Ottiene l'URI (Uniform Resource Identifier) della pagina di presentazione dell'app nel catalogo Web di Windows Store.

Metodi

GetAppPurchaseCampaignIdAsync()	Recupera l'ID campagna promozionale per l'app corrente.
GetAppReceiptAsync()	Richiede tutte le ricevute per l'acquisto dell'app e di tutti i prodotti in-app. Per esempi di come è possibile usare le informazioni sulla ricezione, vedere Uso delle ricevute per verificare gli acquisti di prodotti.
GetCustomerCollectionsIdAsync(String, String)	Recupera una chiave ID di Microsoft Store che può essere usata per eseguire query sui diritti del prodotto o per l'utilizzo dei diritti del prodotto di proprietà dell'utente corrente.
GetCustomerPurchaseIdAsync(String, String)	Recupera una chiave ID di Microsoft Store che può essere usata per concedere i diritti per i prodotti gratuiti per conto dell'utente corrente.
GetProductReceiptAsync(String)	Richiede la ricevuta per l'ID prodotto specificato. Per esempi di come è possibile usare le informazioni sulla ricezione, vedere Uso delle ricevute per verificare gli acquisti di prodotti.
GetUnfulfilledConsumablesAsync()	Restituisce un elenco di prodotti di consumo acquistati in-app che non sono stati segnalati a Microsoft Store come soddisfatti.
LoadListingInformationAsync()	Carica le informazioni sulla presentazione dell'app in modo asincrono. L'oggetto ListingInformation restituito contiene informazioni sull'elenco (ad esempio, nome, prezzo, classificazione dell'età) specifiche per il mercato in cui risiede attualmente l'utente. Vengono inoltre fornite le informazioni sulla presentazione per i prodotti in-app disponibili.
LoadListingInformationByKeywordsAsync(IIterable<String>)	Carica le informazioni sull'elenco delle app in modo asincrono, restituendo funzionalità e prodotti nella raccolta ProductListings che corrispondono a tutte le parole chiave fornite.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Carica le informazioni sull'elenco delle app in modo asincrono, restituendo funzionalità e prodotti nella raccolta ProductListings che corrispondono a uno qualsiasi degli ID prodotti specificati.
ReportConsumableFulfillmentAsync(String, Guid)	Notifica a Microsoft Store che l'acquisto di un componente aggiuntivo di consumo (chiamato anche prodotto in-app o IAP) viene soddisfatto e che l'utente ha il diritto di accedere al contenuto.
ReportProductFulfillment(String)	Notifica a Microsoft Store che l'applicazione ha soddisfatto il prodotto in-app. Questo prodotto non può essere acquistato nuovamente fino a quando l'app non ha confermato l'adempimento usando questo metodo.
RequestAppPurchaseAsync(Boolean)	Richiede l'acquisto di una licenza di app completa.
RequestProductPurchaseAsync(String)	Richiede l'acquisto di un componente aggiuntivo (chiamato anche prodotto in-app o IAP). Inoltre, la chiamata a questo metodo visualizza l'interfaccia utente usata per completare la transazione tramite Microsoft Store.
RequestProductPurchaseAsync(String, Boolean)	Nota [RequestProductPurchaseAsync(String, Boolean) può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece RequestProductPurchaseAsync(String). Richiede l'acquisto di un componente aggiuntivo (chiamato anche prodotto in-app o IAP). Inoltre, la chiamata a questo metodo visualizza l'interfaccia utente usata per completare la transazione tramite Microsoft Store.
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	Richiede l'acquisto di un componente aggiuntivo (chiamato anche prodotto in-app o IAP). Inoltre, la chiamata a questo metodo visualizza l'interfaccia utente usata per completare la transazione tramite Microsoft Store. Questo overload include parametri che è possibile usare per visualizzare i dettagli per un'offerta specifica all'interno di un catalogo elevato di acquisti in-app rappresentati da una singola voce del prodotto nello Store.

Si applica a

Condividi tramite