PackageExtensionCatalog.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<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) Type d'événement
Remarques
L’argument d’événement , PackageExtensionPackageInstalledEventArgs.Extensions, contient une liste d’extensions dans le package d’extensions.
Les extensions sont délimitées par le <uap17:PackageExtension Name=...> défini dans le fichier Package.appxmanifest de l’extension. Seules les extensions qui correspondent au <uap17:PackageExtension 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 l’exactitude de chaque extension de package et pour fournir à l’utilisateur la possibilité de l’utiliser.
L’unité de déploiement d’un PackageExtension 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 PackageExtension .
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 PackageExtension.Id pour faire la distinction entre les extensions dans le même package. Pour identifier de manière unique une extension dans votre package, envisagez de concaténer Package.Id et PackageExtension.Id :
_uniqueId = yourPackageExtension.Package.Id + "|" + yourPackageExtension.Id;
Cela garantit que chaque PackageExtension a un nom unique que vous pouvez utiliser pour le suivre. Nous vous recommandons de l’utiliser comme clé pour vos PackageExtensions afin que vous puissiez identifier efficacement et correctement si un PackageExtension donné est un package que vous connaissez déjà.