AppExtensionCatalog.PackageInstalled 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 installiert wird.
// Register
event_token PackageInstalled(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;
// Revoke with event_revoker
AppExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageInstalledEventArgs> PackageInstalled;function onPackageInstalled(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
appExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
appExtensionCatalog.onpackageinstalled = onPackageInstalled;Public Custom Event PackageInstalled As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageInstalledEventArgs) Ereignistyp
Hinweise
Das Ereignisargument AppExtensionPackageInstalledEventArgs.Extensions enthält eine Liste von Erweiterungen innerhalb des Erweiterungspakets.
Erweiterungen werden durch das <uap3:AppExtension Name=...> in der Datei Package.appxmanifest der Erweiterung definierte Bereich festgelegt. Nur Erweiterungen, die mit dem <uap3:AppExtension Name=...> in der Datei Package.appxmanifest des Hosts definierten übereinstimmen, befinden sich in der Liste der Erweiterungen.
Ein Ereignishandler für dieses Ereignis ist ein guter Ort, um jede App-Erweiterung auf Richtigkeit zu untersuchen und dem Benutzer die Option zur Verwendung bereitzustellen.
Die Bereitstellungseinheit für eine AppExtension ist das Paket. Aus diesem Grund ist dies ein Paketinstallationsereignis und kein AppExtension-Installationsereignis .
In der Regel gibt es nur eine Erweiterung in einem Paket. Bereiten Sie sich jedoch darauf vor, den Fall zu behandeln, in dem mehrere Erweiterungen im Paket vorhanden sind.
Verwenden Sie AppExtension.Id , um zwischen Erweiterungen im selben Paket zu unterscheiden. Um eine Erweiterung in Ihrer App eindeutig zu identifizieren, erwägen Sie die Verkettung von AppInfo.AppUserModelId und AppExtension.Id:
_uniqueId = yourAppExtention.AppInfo.AppUserModelId + "!" + yourAppExtention.Id;
Dadurch wird sichergestellt, dass jede AppExtension über einen eindeutigen Namen verfügt, mit dem Sie sie in Ihrer App nachverfolgen können. Es wird empfohlen, dies als Schlüssel für Ihre AppExtensions zu verwenden, damit Sie effizient und ordnungsgemäß feststellen können, ob eine bestimmte AppExtension bereits bekannt ist.