Freigeben über


StoreContext Klasse

Definition

Stellt Mitglieder bereit, die Sie verwenden können, um auf Microsoft Store-bezogene Daten für die aktuelle App zuzugreifen und diese zu verwalten. Beispielsweise können Sie Mitglieder dieser Klasse verwenden, um Microsoft Store-Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder die von der App angebotenen Produkte zu erwerben oder Paketupdates für die App herunterzuladen und zu installieren.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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
Vererbung
Object Platform::Object IInspectable StoreContext
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Services.Store.StoreContract (eingeführt in v1.0)

Hinweise

Hinweis

Diese Klasse und der Rest des Windows.Services.Store-Namespace wurden in Windows 10 Version 1607 eingeführt. Diese Klasse kann nur in Projekten verwendet werden, die Windows 10 Anniversary Edition (10.0; Build 14393) oder eine höhere Version in Visual Studio. Wenn Ihr Projekt auf eine frühere Version von Windows 10 abzielt, müssen Sie den Windows.ApplicationModel.Store-Namespace anstelle des Windows.Services.Store-Namespace verwenden. Weitere Informationen finden Sie unter In-App-Käufe und Testversionen.

Die StoreContext-Klasse ist der Standard Einstiegspunkt zum Windows.Services.Store-Namespace. Verwenden Sie Mitglieder dieser Klasse, um Aufgaben auszuführen, z. B. das Abrufen von Microsoft Store-Einträgen und Lizenzinformationen für die aktuelle App, den Kauf der aktuellen App oder Add-Ons, die von der App angeboten werden, oder das Herunterladen und Installieren von Paketupdates für die App. Andere Klassen und Typen in diesem Namespace stellen Elemente wie Add-Ons für die App, Lizenzen für die App und ihre Add-Ons sowie Microsoft Store-Eintragsinformationen für die App dar.

Verwenden Sie eine der folgenden statischen Methoden, um ein StoreContext-Objekt abzurufen:

  • GetDefault: Verwenden Sie diese Methode in Einzelbenutzer-Apps (also Apps, die nur im Kontext des Benutzers ausgeführt werden, der die App gestartet hat). Diese Methode ruft ein StoreContext-Objekt ab, mit dem Sie auf Microsoft Store-bezogene Daten für den Benutzer zugreifen und diese verwalten können. Die meisten Apps für die universelle Windows-Plattform (UWP) sind Einzelbenutzer-Apps.

    Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
    
  • GetForUser: Verwenden Sie diese Methode in Apps mit mehreren Benutzern. Diese Methode ruft ein StoreContext-Objekt ab, mit dem Sie auf Microsoft Store-bezogene Daten für einen bestimmten Benutzer zugreifen und diese verwalten können. Weitere Informationen zu Mehrbenutzer-Apps finden Sie unter Einführung in Anwendungen mit mehreren Benutzern.

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

Nachdem Sie über ein StoreContext-Objekt verfügen, können Sie mit dem Aufrufen von Methoden beginnen, um eine App oder ein Add-On für den aktuellen Benutzer und andere Aufgaben zu erwerben. Weitere Informationen finden Sie in den folgenden Artikeln:

Sie können auch ein StoreContext-Objekt verwenden, um Paketupdates für die App herunterzuladen und zu installieren. Weitere Informationen finden Sie unter Herunterladen und Installieren von Paketupdates für Ihre App.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
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

Eigenschaften

CanSilentlyDownloadStorePackageUpdates

Ruft einen Wert ab, der angibt, ob Paketupdates für die aktuelle App heruntergeladen werden können, ohne dem Benutzer eine Benachrichtigungsbenutzeroberfläche anzuzeigen.

User

Ruft Informationen über den Benutzer ab, der dem aktuellen StoreContext-Objekt in einer Mehrbenutzer-App zugeordnet ist.

Methoden

AcquireStoreLicenseForOptionalPackageAsync(Package)

Ruft eine Lizenz für das angegebene DLC-Add-On-Paket (Downloadable Content) für die aktuelle App ab.

CanAcquireStoreLicenseAsync(String)

Ruft einen Wert ab, der angibt, ob eine Lizenz für das angegebene DLC-Add-On (Downloadable Content) der aktuellen App für den aktuellen Benutzer erworben werden kann.

CanAcquireStoreLicenseForOptionalPackageAsync(Package)

Ruft einen Wert ab, der angibt, ob eine Lizenz für das angegebene DLC-Paket (Downloadable Content) der aktuellen App für den aktuellen Benutzer erworben werden kann.

DownloadAndInstallStorePackagesAsync(IIterable<String>)

Lädt die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App aus dem Microsoft Store herunter und installiert sie, ohne dass dem Benutzer ein Dialogfeld zur Benachrichtigungsbenutzeroberfläche angezeigt wird.

FindStoreProductForPackageAsync(IIterable<String>, Package)

Ruft Store-Produktdetails für die App oder das Add-On ab, das dem angegebenen Paket zugeordnet ist.

GetAppAndOptionalStorePackageUpdatesAsync()

Ruft die Sammlung von Paketen für die aktuelle App ab, für die Updates zum Download aus dem Microsoft Store verfügbar sind, einschließlich optionaler Pakete für die App.

GetAppLicenseAsync()

Ruft Lizenzinformationen für die aktuelle App ab, einschließlich Lizenzen für Add-Ons für die aktuelle App.

GetAssociatedStoreProductsAsync(IIterable<String>)

Ruft Microsoft Store-Eintragsinformationen für die Produkte ab, die in der aktuellen App erworben werden können.

GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>)

Stellt Mitglieder bereit, die Sie verwenden können, um auf Microsoft Store-bezogene Daten für die aktuelle App zuzugreifen und diese zu verwalten. Beispielsweise können Sie Mitglieder dieser Klasse verwenden, um Microsoft Store-Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder die von der App angebotenen Produkte zu erwerben oder Paketupdates für die App herunterzuladen und zu installieren.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32)

Ruft Microsoft Store-Eintragsinformationen für die Produkte ab, die in der aktuellen App erworben werden können. Diese Methode unterstützt das Paging, um die Ergebnisse zurückzugeben.

GetAssociatedStoreQueueItemsAsync()

Ruft Informationen zu allen neuen oder aktualisierten Paketen ab, die sich in der Download- und Installationswarteschlange für die aktuelle App befinden.

GetConsumableBalanceRemainingAsync(String)

Ruft den verbleibenden Saldo für das angegebene verbrauchsbare Add-On für die aktuelle App ab.

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.

GetDefault()

Ruft ein StoreContext-Objekt ab, das verwendet werden kann, um auf Microsoft Store-bezogene Daten für den aktuellen Benutzer im Kontext der aktuellen App zuzugreifen und diese zu verwalten.

GetForUser(User)

Ruft ein StoreContext-Objekt ab, das verwendet werden kann, um auf Microsoft Store-bezogene Daten für den angegebenen Benutzer im Kontext der aktuellen App zuzugreifen und diese zu verwalten.

GetStoreProductForCurrentAppAsync()

Ruft Microsoft Store-Auflistungsinformationen für die aktuelle App ab und bietet Zugriff auf eine Methode, mit der Sie die App für den aktuellen Benutzer erwerben können.

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

Ruft Microsoft Store-Eintragsinformationen für die angegebenen Produkte ab, die der aktuellen App zugeordnet sind.

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

Ruft Microsoft Store-Auflistungsinformationen für die angegebenen Produkte ab, die der aktuellen App zugeordnet sind, mit der Option, einen Filter für die Abfrage zu verwenden.

GetStoreQueueItemsAsync(IIterable<String>)

Ruft Informationen zu den angegebenen neuen oder aktualisierten Paketen ab, die sich in der Download- und Installationswarteschlange für die aktuelle App befinden.

GetUserCollectionAsync(IIterable<String>)

Ruft Microsoft Store-Informationen für die Add-Ons der aktuellen App ab, für die der Benutzer gekauft hat.

GetUserCollectionWithPagingAsync(IIterable<String>, UInt32)

Ruft Microsoft Store-Informationen für die Add-Ons der aktuellen App ab, für die der Benutzer gekauft hat. Diese Methode unterstützt das Paging, um die Ergebnisse zurückzugeben.

GetUserPurchaseHistoryAsync(IIterable<String>)

Stellt Mitglieder bereit, die Sie verwenden können, um auf Microsoft Store-bezogene Daten für die aktuelle App zuzugreifen und diese zu verwalten. Beispielsweise können Sie Mitglieder dieser Klasse verwenden, um Microsoft Store-Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder die von der App angebotenen Produkte zu erwerben oder Paketupdates für die App herunterzuladen und zu installieren.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

ReportConsumableFulfillmentAsync(String, UInt32, Guid)

Meldet ein verbrauchsbares Add-On für die aktuelle App als erfüllt im Microsoft Store.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

Versucht, die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Versucht, die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App mit den angegebenen Installationsoptionen aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Versucht, die angegebenen Paketupdates für die aktuelle App aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Versucht, die angegebenen Paketupdates für die aktuelle App aus dem Microsoft Store herunterzuladen. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestPurchaseAsync(String)

Fordert den Kauf für die angegebene App oder das angegebene Add-On an und zeigt die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestPurchaseAsync(String, StorePurchaseProperties)

Fordert den Kauf für die angegebene App oder das angegebene Add-On an und zeigt die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. Diese Methode bietet die Möglichkeit, zusätzliche Details für ein bestimmtes Angebot in einem großen Katalog von Produkten anzugeben, die durch einen einzelnen Eintrag im Microsoft Store dargestellt werden, einschließlich des Produktnamens, der dem Benutzer während des Kaufs angezeigt werden soll.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestPurchaseByInAppOfferTokenAsync(String)

Stellt Mitglieder bereit, die Sie verwenden können, um auf Microsoft Store-bezogene Daten für die aktuelle App zuzugreifen und diese zu verwalten. Beispielsweise können Sie Mitglieder dieser Klasse verwenden, um Microsoft Store-Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder die von der App angebotenen Produkte zu erwerben oder Paketupdates für die App herunterzuladen und zu installieren.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

RequestRateAndReviewAppAsync()

Fordert den Benutzer auf, die App zu bewerten und zu überprüfen. Diese Methode zeigt die Benutzeroberfläche für den Benutzer an, um eine Store-Bewertung auszuwählen und eine optionale Store-Überprüfung für das Produkt hinzuzufügen.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestUninstallStorePackageAsync(Package)

Versucht, das angegebene optionale Paket für die aktuelle App zu deinstallieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

RequestUninstallStorePackageByStoreIdAsync(String)

Versucht, das angegebene DLC-Paket (Downloadable Content) für die aktuelle App zu deinstallieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>)

Legt die Reihenfolge fest, in der die angegebenen Pakete in der Download- und Installationswarteschlange für die aktuelle App installiert werden sollen.

TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Versucht, die angegebenen Paketupdates für die aktuelle App aus dem Microsoft Store herunterzuladen und zu installieren, ohne dem Benutzer eine Benachrichtigungsbenutzeroberfläche anzuzeigen.

TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)

Versucht, die angegebenen Paketupdates für die aktuelle App aus dem Microsoft Store herunterzuladen, ohne dem Benutzer eine Benachrichtigungsbenutzeroberfläche anzuzeigen.

UninstallStorePackageAsync(Package)

Deinstalliert das angegebene optionale Paket für die aktuelle App, ohne dass dem Benutzer ein Benachrichtigungsdialogfeld angezeigt wird.

UninstallStorePackageByStoreIdAsync(String)

Deinstalliert das angegebene DLC-Paket (Downloadable Content) für die aktuelle App, ohne dass dem Benutzer ein Dialogfeld zur Benachrichtigungsbenutzeroberfläche angezeigt wird.

Ereignisse

OfflineLicensesChanged

Wird ausgelöst, wenn sich die status der App-Lizenz ändert (z. B. ist der Testzeitraum abgelaufen oder der Benutzer hat die Vollversion der App erworben).

Gilt für:

Weitere Informationen