PackageExtensionCatalog.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<PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;
// Revoke with event_revoker
PackageExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs const&> const& handler) const;public event TypedEventHandler<PackageExtensionCatalog,PackageExtensionPackageInstalledEventArgs> PackageInstalled;function onPackageInstalled(eventArgs) { /* Your code */ }
packageExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
packageExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
packageExtensionCatalog.onpackageinstalled = onPackageInstalled;Public Custom Event PackageInstalled As TypedEventHandler(Of PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs) Ereignistyp
Hinweise
Das Ereignisargument PackageExtensionPackageInstalledEventArgs.Extensions enthält eine Liste von Erweiterungen innerhalb des Erweiterungspakets.
Erweiterungen werden durch das <uap17:PackageExtension Name=...> in der Datei Package.appxmanifest der Erweiterung definierte Bereich festgelegt. Nur Erweiterungen, die mit dem <uap17:PackageExtension 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 Paketerweiterung auf Richtigkeit zu untersuchen und dem Benutzer die Option zur Verwendung bereitzustellen.
Die Bereitstellungseinheit für eine PackageExtension ist das Paket. Aus diesem Grund ist dies ein Package-Installationsereignis und kein PackageExtension-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 PackageExtension.Id , um zwischen Erweiterungen im selben Paket zu unterscheiden. Um eine Erweiterung in Ihrem Paket eindeutig zu identifizieren, sollten Sie Package.Id und PackageExtension.Id verketten:
_uniqueId = yourPackageExtension.Package.Id + "|" + yourPackageExtension.Id;
Dadurch wird sichergestellt, dass jede PackageExtension über einen eindeutigen Namen verfügt, den Sie zum Nachverfolgen verwenden können. Es wird empfohlen, dies als Schlüssel für Ihre PackageExtensions zu verwenden, damit Sie effizient und ordnungsgemäß ermitteln können, ob es sich bei einer bestimmten PackageExtension um einen Schlüssel handelt, den Sie bereits kennen.