CurrentApp 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.
Definisce metodi e proprietà che puoi usare per ottenere informazioni sulla licenza 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 Edizione dell'anniversario di Windows 10 (10.0; Build 14393) o una versione successiva in Visual Studio (ovvero hai come destinazione Windows 10, versione 1607 o successiva), ti consigliamo di usare invece lo spazio dei nomi Windows.Services.Store. Per altre informazioni, vedere acquisti in-app e versioni di valutazione. La classe CurrentApp
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à
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| 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 devi avere un account per 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 (il cui 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à
| Nome | Descrizione |
|---|---|
| AppId |
Ottiene il GUID generato da Windows Store quando l'app è stata certificata per la presentazione in Windows Store. Nota Una volta che l'app si trova in Windows Store, gli aggiornamenti futuri delle app o le modifiche apportate alla descrizione dell'app non genereranno una modifica a 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
| Nome | Descrizione |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
Recupera l'ID campagna promozionale per l'app corrente. |
| GetAppReceiptAsync() |
Richiede tutte le ricevute per l'acquisto dell'app e dei prodotti in-app. Per esempi di come è possibile usare le informazioni sulla ricevuta, 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 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. |
| GetProductReceiptAsync(String) |
Richiede la ricevuta per l'ID prodotto specificato. Per esempi di come è possibile usare le informazioni sulla ricevuta, 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 di presentazione dell'app in modo asincrono. L'oggetto ListingInformation restituito contiene informazioni sull'inserzione (ad esempio, nome, prezzo, fascia d'età) specifiche del mercato in cui risiede attualmente l'utente. Inoltre, vengono fornite anche le informazioni di presentazione per i prodotti in-app disponibili. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Carica le informazioni di presentazione dell'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 di presentazione dell'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 (detto 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'evasione usando questo metodo. |
| RequestAppPurchaseAsync(Boolean) |
Importante La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati. Richiede l'acquisto di una licenza completa dell'app. |
| RequestProductPurchaseAsync(String, Boolean) |
Importante La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati. 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 (detto anche prodotto in-app o IAP). Inoltre, chiamando questo metodo viene visualizzata l'interfaccia utente usata per completare la transazione tramite Microsoft Store. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Importante La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati. Richiede l'acquisto di un componente aggiuntivo (detto anche prodotto in-app o IAP). Inoltre, chiamando questo metodo viene visualizzata 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 ampio catalogo di acquisti in-app rappresentati da una singola voce di prodotto nello Store. |
| RequestProductPurchaseAsync(String) |
Importante La funzionalità di acquisto in-app non è supportata nelle applicazioni con privilegi elevati. Richiede l'acquisto di un componente aggiuntivo (detto anche prodotto in-app o IAP). Inoltre, chiamando questo metodo viene visualizzata l'interfaccia utente usata per completare la transazione tramite Microsoft Store. |
Si applica a
Vedi anche
- di esempio
Store () - 'app di valutazione e l'esempio di acquisto in-app ()