StoreContext Klasse
Definition
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.
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 StoreContextPublic NotInheritable Class StoreContext- Vererbung
- 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:
- In-App-Käufe und Testversionen
- Abrufen von Produktinformationen zu Apps und Add-Ons
- Abrufen von Lizenzinformationen zu Apps und Add-Ons
- Aktivieren von In-App-Käufen von Apps und Add-Ons
- Unterstützen von Endverbraucher-Add-On-Käufen
- Implementieren einer Testversion der App
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). |