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, mit denen Sie auf Microsoft Store-bezogene Daten für die aktuelle App zugreifen und diese verwalten können. Sie können beispielsweise Mitglieder dieser Klasse verwenden, um Microsoft Store Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder Produkte zu erwerben, die von der App angeboten werden, oder Paketupdates für die App herunterladen und installieren.
In einer Desktop-App müssen Sie das Objekt vor der Verwendung einer Instanz dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt, dem Fensterhandle des Besitzers zuordnen. 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
| Anforderungen | Beschreibung |
|---|---|
| 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 der Windows. Services.Store Namespace wurde in Windows 10, Version 1607, eingeführt. Diese Klasse kann nur in Projekten verwendet werden, die auf Windows 10 Anniversary Edition (10.0) abzielen. Build 14393) oder eine spätere Version in Visual Studio. Wenn Ihr Projekt auf eine frühere Version von Windows 10 ausgerichtet ist, müssen Sie die Windows verwenden. ApplicationModel.Store Namespace anstelle des Windows. Services.Store Namespace. Weitere Informationen finden Sie unter In-App-Käufe und Testversionen.
Die StoreContext-Klasse ist der Haupteinstiegspunkt für die Windows. Services.Store Namespace. Verwenden Sie Mitglieder dieser Klasse, um Aufgaben auszuführen, z. B. das Abrufen Microsoft Store Eintrags- 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 dar und Microsoft Store Eintragsinformationen für die App.
Verwenden Sie eine der folgenden statischen Methoden, um ein StoreContext-Objekt abzurufen:
GetDefault: Verwenden Sie diese Methode in Einzelbenutzer-Apps (d. h. Apps, die nur im Kontext des Benutzers ausgeführt werden, der die App gestartet hat). Diese Methode ruft ein StoreContext-Objekt ab, das Sie verwenden können, um auf Microsoft Store-bezogene Daten für den Benutzer zuzugreifen und diese zu verwalten. Die meisten UWP-Apps (Universelle Windows-Plattform) sind Einzelbenutzer-Apps.
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();GetForUser: Verwenden Sie diese Methode in Mehrbenutzer-Apps. 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 Apps mit mehreren Benutzern finden Sie in der Einführung in Mehrbenutzeranwendungen.
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
- Produktinformationen zu Apps und Add-Ons abrufen
- Lizenzinformationen für Apps und Add-Ons abrufen
- In-App-Käufe für Apps und Erweiterungen aktivieren
- Käufe von verbrauchbaren Erweiterungen aktivieren
- Implementieren Sie eine Testversion Ihrer 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 | Mehrwert |
|---|---|---|
| 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
| Name | Beschreibung |
|---|---|
| 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 zum Benutzer ab, der dem aktuellen StoreContext -Objekt in einer Mehrbenutzer-App zugeordnet ist. |
Methoden
| Name | Beschreibung |
|---|---|
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
Erwirbt eine Lizenz für das angegebene DLC-Add-On-Paket (Downloadable Content) für die aktuelle App. |
| CanAcquireStoreLicenseAsync(String) |
Ruft einen Wert ab, der angibt, ob eine Lizenz für das angegebene herunterladbare Inhalts-Add-On (DLC) 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 herunterladbare Inhaltspaket (DLC) 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 dem Benutzer ein Dialogfeld für die Benachrichtigungsbenutzeroberfläche anzuzeigen. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
Ruft Store-Produktdetails für die App oder das Add-On ab, die dem angegebenen Paket zugeordnet ist. |
| GetAppAndOptionalStorePackageUpdatesAsync() |
Ruft die Sammlung von Paketen für die aktuelle App ab, die Updates für den 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, mit denen Sie auf Microsoft Store-bezogene Daten für die aktuelle App zugreifen und diese verwalten können. Sie können beispielsweise Mitglieder dieser Klasse verwenden, um Microsoft Store Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder Produkte zu erwerben, die von der App angeboten werden, oder Paketupdates für die App herunterladen und installieren. In einer Desktop-App müssen Sie das Objekt vor der Verwendung einer Instanz dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt, dem Fensterhandle des Besitzers zuordnen. 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 Restsaldo für das angegebene Verbrauchs-Add-On für die aktuelle App ab. |
| GetCustomerCollectionsIdAsync(String, String) |
Ruft einen Microsoft Store ID-Schlüssel ab, der zum Abfragen von Produktberechtigungen oder zum Verbrauch von Produktberechtigungen verwendet werden kann, die dem aktuellen Benutzer gehören. |
| GetCustomerPurchaseIdAsync(String, String) |
Ruft einen Microsoft Store ID-Schlüssel ab, der zum Erteilen von Berechtigungen für kostenlose Produkte im Namen des aktuellen Benutzers verwendet werden kann. |
| GetDefault() |
Ruft ein StoreContext-Objekt ab, das für den Zugriff auf Microsoft Store-bezogene Daten für den aktuellen Benutzer im Kontext der aktuellen App verwendet werden kann. |
| GetForUser(User) |
Ruft ein StoreContext-Objekt ab, das für den Zugriff auf Microsoft Store-bezogene Daten für den angegebenen Benutzer im Kontext der aktuellen App verwendet werden kann. |
| GetStoreProductForCurrentAppAsync() |
Ruft Microsoft Store Eintragsinformationen 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>, StoreProductOptions) |
Ruft Microsoft Store Eintragsinformationen für die angegebenen Produkte ab, die der aktuellen App zugeordnet sind, mit der Option, einen Filter für die Abfrage zu verwenden. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>) |
Ruft Microsoft Store Eintragsinformationen für die angegebenen Produkte ab, die der aktuellen App zugeordnet sind. |
| 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 erworben hat. |
| GetUserCollectionWithPagingAsync(IIterable<String>, UInt32) |
Ruft Microsoft Store Informationen für die Add-Ons der aktuellen App ab, für die der Benutzer erworben hat. Diese Methode unterstützt das Paging, um die Ergebnisse zurückzugeben. |
| GetUserPurchaseHistoryAsync(IIterable<String>) |
Stellt Mitglieder bereit, mit denen Sie auf Microsoft Store-bezogene Daten für die aktuelle App zugreifen und diese verwalten können. Sie können beispielsweise Mitglieder dieser Klasse verwenden, um Microsoft Store Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder Produkte zu erwerben, die von der App angeboten werden, oder Paketupdates für die App herunterladen und installieren. In einer Desktop-App müssen Sie das Objekt vor der Verwendung einer Instanz dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt, dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Meldet ein Verbrauchs-Add-On für die aktuelle App als erfüllt im Microsoft Store. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Versucht, die angegebenen herunterladbaren Inhaltspakete (DLC) für die aktuelle App aus dem Microsoft Store mit den angegebenen Installationsoptionen herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert. Von Bedeutung Diese Methode muss im UI-Thread aufgerufen werden. |
| 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. Von Bedeutung 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. Von Bedeutung 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. Von Bedeutung Diese Methode muss im UI-Thread aufgerufen werden. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
Fordert den Kauf für die angegebene App oder das Add-On an und zeigt die Ui an, die zum Abschließen der Transaktion über die 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 eine einzelne Auflistung in der Microsoft Store dargestellt werden, einschließlich des Produktnamens, der während des Kaufs für den Benutzer angezeigt werden soll. Von Bedeutung Diese Methode muss im UI-Thread aufgerufen werden. Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. |
| RequestPurchaseAsync(String) |
Fordert den Kauf für die angegebene App oder das Add-On an und zeigt die Ui an, die zum Abschließen der Transaktion über die Microsoft Store verwendet wird. Von Bedeutung Diese Methode muss im UI-Thread aufgerufen werden. Von Bedeutung In-App-Kauffunktionen werden in Anwendungen mit erhöhten Rechten nicht unterstützt. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
Stellt Mitglieder bereit, mit denen Sie auf Microsoft Store-bezogene Daten für die aktuelle App zugreifen und diese verwalten können. Sie können beispielsweise Mitglieder dieser Klasse verwenden, um Microsoft Store Eintrags- und Lizenzinformationen für die aktuelle App abzurufen, die aktuelle App oder Produkte zu erwerben, die von der App angeboten werden, oder Paketupdates für die App herunterladen und installieren. In einer Desktop-App müssen Sie das Objekt vor der Verwendung einer Instanz dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt, dem Fensterhandle des Besitzers zuordnen. 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 des Benutzers an, um eine Store-Bewertung auszuwählen und eine optionale Store-Rezension für das Produkt hinzuzufügen. Von Bedeutung Diese Methode muss im UI-Thread aufgerufen werden. Von Bedeutung In-App-Funktionen für Rate und Überprüfung werden in Anwendungen mit erhöhten Rechten nicht unterstützt. |
| 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 herunterladbare Inhaltspaket (DLC) 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 dem Benutzer ein Dialogfeld für die Benachrichtigungsbenutzeroberfläche anzuzeigen. |
| UninstallStorePackageByStoreIdAsync(String) |
Deinstalliert das angegebene herunterladbare Inhaltspaket (DLC) für die aktuelle App, ohne dem Benutzer ein Benachrichtigungs-UI-Dialogfeld anzuzeigen. |
Ereignisse
| Name | Beschreibung |
|---|---|
| OfflineLicensesChanged |
Wird ausgelöst, wenn sich der Status der App-Lizenz ändert (z. B. ist der Testzeitraum abgelaufen oder der Benutzer hat die Vollversion der App erworben). |