AppExtensionCatalog.PackageInstalled Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Événement déclenché lors de l’installation d’un package d’extension.
// 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) Type d'événement
Remarques
L’argument d’événement , AppExtensionPackageInstalledEventArgs.Extensions, contient une liste d’extensions dans le package d’extensions.
Les extensions sont délimitées par le <uap3:AppExtension Name=...> défini dans le fichier Package.appxmanifest de l’extension. Seules les extensions qui correspondent au <uap3:AppExtension Name=...> défini dans le fichier Package.appxmanifest de l’hôte figurent dans la liste des extensions.
Un gestionnaire d’événements pour cet événement est un bon endroit pour examiner chaque extension d’application et pour fournir à l’utilisateur la possibilité de l’utiliser.
L’unité de déploiement d’un AppExtension est le package. C’est pourquoi il s’agit d’un événement d’installation de package et non d’un événement d’installation AppExtension .
En règle générale, il n’y aura qu’une seule extension dans un package. Toutefois, préparez-vous à gérer le cas où il existe plusieurs extensions dans le package.
Utilisez AppExtension.Id pour faire la distinction entre les extensions dans le même package. Pour identifier de manière unique une extension dans votre application, envisagez de concaténer AppInfo.AppUserModelId et AppExtension.Id :
_uniqueId = yourAppExtention.AppInfo.AppUserModelId + "!" + yourAppExtention.Id;
Cela garantit que chaque AppExtension a un nom unique que vous pouvez utiliser pour le suivre dans votre application. Nous vous recommandons de l’utiliser comme clé pour vos AppExtensions afin que vous puissiez identifier efficacement et correctement si une AppExtension donnée est celle que vous connaissez déjà.