AppExtensionCatalog.PackageStatusChanged Ereignis

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.AppExtensions
Bearbeiten

Ereignis, das ausgelöst wird, wenn ein Erweiterungspaket im Katalog entfernt, aktualisiert oder installiert wird.

// Register
event_token PackageStatusChanged(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void PackageStatusChanged(event_token const* cookie) const;

// Revoke with event_revoker
AppExtensionCatalog::PackageStatusChanged_revoker PackageStatusChanged(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs const&> const& handler) const;
public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageStatusChangedEventArgs> PackageStatusChanged;
function onPackageStatusChanged(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packagestatuschanged", onPackageStatusChanged);
appExtensionCatalog.removeEventListener("packagestatuschanged", onPackageStatusChanged);
- or -
appExtensionCatalog.onpackagestatuschanged = onPackageStatusChanged;
Public Custom Event PackageStatusChanged As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs)

Ereignistyp

TypedEventHandler<AppExtensionCatalog,AppExtensionPackageStatusChangedEventArgs>

Hinweise

Dieses Ereignis hilft Ihnen zu erkennen, wenn ein Paket nicht mehr verfügbar, gültig oder geändert wurde. Behandeln Sie dieses Ereignis, um zu bestimmen, wann eine Erweiterung möglicherweise nicht mehr gültig ist und deaktiviert werden soll. Eine häufige Verwendung für dieses Ereignis besteht darin, zu erkennen, ob das App-Paket, das die Erweiterung bereitstellt, auf Wechselmedien installiert ist. Wenn der Benutzer die Medien entfernt, die das Paket enthalten, wird dieses Ereignis für dieses Paket ausgelöst.

Die PackageStatus-Klasse stellt die möglichen Paket-status-Zustände bereit. Verwenden Sie PackageStatus.VerifyIsOk , um zu ermitteln, ob sich das Paket in einem guten Zustand befindet. Wenn false zurückgegeben wird, können Sie PackageStatus.LicenseIssue oder PackageStatus.PackageOffline überprüfen und eine spezielle Behandlung für diese Situationen bereitstellen. Wenn der Paketstatus nicht OK ist, sollten Sie ihn in der Regel deaktivieren. Es empfiehlt sich, PackageStatus.VerifyIsOk immer dann aufzurufen, wenn Sie eine Erweiterung laden möchten.

Erwägen Sie die Behandlung dieses Ereignisses, um auf der Benutzeroberfläche des Erweiterungs-Managers einen Hinweis darauf zu geben, dass die Erweiterung deaktiviert oder nicht verwendbar ist, weil ein Fehler mit dem Paket vorliegt.

Behandeln Sie dieses Ereignis weiterhin, auch wenn Sie festgestellt haben, dass ein Problem mit einem Paket vorliegt, da der Benutzer das Paket möglicherweise aktualisieren kann und es dann ok ist, es zu laden.

Wie PackageUpdating und PackageUninstalling übergibt dieses Ereignis nur das Paket, das status geändert wurde. Es liegt an Ihnen, das Paket mit den appExtensions abzugleichen, die Sie geladen haben, um zu bestimmen, welche Erweiterungen von der status Änderung betroffen sind.

Gilt für: