CurrentApp Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.Store

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Definiert Methoden und Eigenschaften, die Sie verwenden können, um Lizenz- und Auflistungsinformationen zur aktuellen App abzurufen und In-App-Produktkäufe durchzuführen.

Hinweis

Die CurrentApp-Klasse und die anderen Typen im Windows.ApplicationModel.Store-Namespace werden nicht mehr mit neuen Features aktualisiert. Wenn Ihr Projekt Windows 10 Anniversary Edition (10.0; Build 14393) oder eine höhere Version in Visual Studio (d. h. Sie zielen auf Windows 10 Version 1607 oder höher ab), wird empfohlen, stattdessen den Windows.Services.Store Namespace zu verwenden. Weitere Informationen finden Sie unter In-App-Käufe und Testversionen. Die CurrentApp-Klasse wird nicht in Windows-Desktopanwendungen unterstützt, die die Desktop-Brücke verwenden, oder in Apps oder Spielen, die eine Entwicklungssandbox im Partner Center verwenden (dies ist z. B. bei jedem Spiel der Fall, das in Xbox Live integriert ist). Diese Produkte müssen den Windows.Services.Store-Namespace verwenden, um In-App-Käufe und Testversionen zu implementieren.

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

Vererbung: Object Platform::Object IInspectable CurrentApp

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Dieses Objekt ruft seine Daten aus dem Microsoft Store ab, sodass Sie über ein Entwicklerkonto verfügen müssen und die App im Microsoft Store veröffentlicht werden muss. Vor der Übermittlung an den Microsoft Store können Sie Ihren Code mit einer simulierten Version dieser Klasse testen (deren Zustand aus einer XML-Datei initialisiert wird). Siehe CurrentAppSimulator.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1511	10586	GetCustomerCollectionsIdAsync
1511	10586	GetCustomerPurchaseIdAsync

Eigenschaften

AppId	Ruft die GUID ab, die vom Windows Store generiert wurde, wenn Ihre App für den Eintrag im Windows Store zertifiziert wurde. Hinweis Sobald sich Ihre App im Windows Store befindet, führen zukünftige App-Updates oder Änderungen an der App-Beschreibung nicht zu einer Änderung der CurrentApp.AppId.
LicenseInformation	Ruft die Lizenzmetadaten für die aktuelle App ab.
LinkUri	Ruft den Uniform Resource Identifier (URI) der Listenseite der App im Webkatalog des Windows Store ab.

Methoden

GetAppPurchaseCampaignIdAsync()	Ruft die Kampagnen-ID der Promotion für die aktuelle App ab.
GetAppReceiptAsync()	Fordert alle Belege für den Kauf der App und aller In-App-Produkte an. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Belegen zum Überprüfen von Produktkäufen.
GetCustomerCollectionsIdAsync(String, String)	Ruft einen Microsoft Store-ID-Schlüssel ab, der verwendet werden kann, um Produktberechtigungen abzufragen oder Produktberechtigungen zu nutzen, die dem aktuellen Benutzer gehören.
GetCustomerPurchaseIdAsync(String, String)	Ruft einen Microsoft Store-ID-Schlüssel ab, mit dem Berechtigungen für kostenlose Produkte im Namen des aktuellen Benutzers erteilt werden können.
GetProductReceiptAsync(String)	Fordert den Beleg für die angegebene Produkt-ID an. Beispiele für die Verwendung von Beleginformationen finden Sie unter Verwenden von Belegen zum Überprüfen von Produktkäufen.
GetUnfulfilledConsumablesAsync()	Gibt eine Liste der erworbenen verbrauchsbaren In-App-Produkte zurück, die nicht als erfüllt im Microsoft Store gemeldet wurden.
LoadListingInformationAsync()	Lädt die Listeninformationen der App asynchron. Das zurückgegebene ListingInformation-Objekt enthält Listeninformationen (z. B. Name, Preis, Altersfreigabe), die für den Markt, in dem sich der Benutzer derzeit befindet, spezifisch sind. Darüber hinaus werden auch die Listeninformationen für verfügbare In-App-Produkte bereitgestellt.
LoadListingInformationByKeywordsAsync(IIterable<String>)	Lädt die App-Auflistungsinformationen asynchron und gibt Features und Produkte in der ProductListings-Auflistung zurück, die allen angegebenen Schlüsselwörtern entsprechen.
LoadListingInformationByProductIdsAsync(IIterable<String>)	Lädt die App-Auflistungsinformationen asynchron und gibt Features und Produkte in der ProductListings-Auflistung zurück, die mit einer der angegebenen Produkt-IDs übereinstimmen.
ReportConsumableFulfillmentAsync(String, Guid)	Benachrichtigt den Microsoft Store, dass der Kauf eines verbrauchsbaren Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) erfüllt ist und dass der Benutzer das Recht hat, auf die Inhalte zuzugreifen.
ReportProductFulfillment(String)	Benachrichtigt den Microsoft Store, dass die Anwendung das In-App-Produkt erfüllt hat. Dieses Produkt kann erst dann erneut erworben werden, wenn die App die Erfüllung mit dieser Methode bestätigt hat.
RequestAppPurchaseAsync(Boolean)	Fordert den Kauf einer vollständigen App-Lizenz an.
RequestProductPurchaseAsync(String)	Fordert den Kauf eines Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) an. Darüber hinaus wird beim Aufrufen dieser Methode die Benutzeroberfläche angezeigt, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird.
RequestProductPurchaseAsync(String, Boolean)	Hinweis [RequestProductPurchaseAsync(String, Boolean) kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen RequestProductPurchaseAsync(String). Fordert den Kauf eines Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) an. Darüber hinaus wird beim Aufrufen dieser Methode die Benutzeroberfläche angezeigt, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird.
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	Fordert den Kauf eines Add-Ons (auch als In-App-Produkt oder IAP bezeichnet) an. Darüber hinaus wird beim Aufrufen dieser Methode die Benutzeroberfläche angezeigt, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. Diese Überladung umfasst Parameter, die Sie verwenden können, um Details für ein bestimmtes Angebot in einem großen Katalog von In-App-Käufen anzuzeigen, der durch einen einzelnen Produkteintrag im Store dargestellt wird.

Gilt für: