PackageExtensionCatalog.PackageStatusChanged Ereignis
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.
Ereignis, das ausgelöst wird, wenn ein Erweiterungspaket im Katalog entfernt, aktualisiert oder installiert wird.
// Register
event_token PackageStatusChanged(TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageStatusChangedEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageStatusChanged(event_token const* cookie) const;
// Revoke with event_revoker
PackageExtensionCatalog::PackageStatusChanged_revoker PackageStatusChanged(auto_revoke_t, TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageStatusChangedEventArgs const&> const& handler) const;public event TypedEventHandler<PackageExtensionCatalog,PackageExtensionPackageStatusChangedEventArgs> PackageStatusChanged;function onPackageStatusChanged(eventArgs) { /* Your code */ }
packageExtensionCatalog.addEventListener("packagestatuschanged", onPackageStatusChanged);
packageExtensionCatalog.removeEventListener("packagestatuschanged", onPackageStatusChanged);
- or -
packageExtensionCatalog.onpackagestatuschanged = onPackageStatusChanged;Public Custom Event PackageStatusChanged As TypedEventHandler(Of PackageExtensionCatalog, PackageExtensionPackageStatusChangedEventArgs) Ereignistyp
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 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 jedes Mal aufzurufen, wenn Sie eine Erweiterung laden.
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 sicher sind, 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 das Package nur mit einem geänderten status. Es liegt an Ihnen, das Paket mit den packageExtensions abzugleichen, die Sie geladen haben, um zu bestimmen, welche Erweiterungen von der status Änderung betroffen sind.