AppExtensionCatalog.PackageStatusChanged É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é lorsqu’un package d’extension dans le catalogue a été supprimé, mis à jour ou installé.
// Register
event_token PackageStatusChanged(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageStatusChanged(event_token const* cookie) const;
// Revoke with event_revoker
AppExtensionCatalog::PackageStatusChanged_revoker PackageStatusChanged(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs const&> const& handler) const;public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageStatusChangedEventArgs> PackageStatusChanged;function onPackageStatusChanged(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packagestatuschanged", onPackageStatusChanged);
appExtensionCatalog.removeEventListener("packagestatuschanged", onPackageStatusChanged);
- or -
appExtensionCatalog.onpackagestatuschanged = onPackageStatusChanged;Public Custom Event PackageStatusChanged As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageStatusChangedEventArgs) Type d'événement
Remarques
Cet événement vous aide à identifier quand un package n’est plus disponible, valide ou a été modifié. Gérez cet événement pour déterminer quand une extension peut ne plus être valide et doit être désactivée. Une utilisation courante de cet événement consiste à détecter si le package d’application fournissant l’extension est installé sur un support amovible. Si l’utilisateur supprime le média contenant le package, cet événement est déclenché pour ce package.
La classe PackageStatus fournit les états status de package possibles. Utilisez PackageStatus.VerifyIsOk pour déterminer si le package est en bon état. S’il retourne false, vous pouvez case activée PackageStatus.LicenseIssue ou PackageStatus.PackageOffline et fournir une gestion spéciale pour ces situations. En règle générale, si l’état du package n’est pas Ok, vous devez le désactiver. Il est recommandé d’appeler PackageStatus.VerifyIsOk chaque fois que vous êtes sur le point de charger une extension.
Envisagez de gérer cet événement pour fournir un indicateur dans votre interface utilisateur du gestionnaire d’extensions indiquant que l’extension est désactivée ou non utilisable en raison d’un problème avec le package.
Continuez à gérer cet événement, même si vous avez déterminé qu’il existe un problème avec un package, car l’utilisateur peut mettre à jour le package et qu’il peut alors être acceptable de charger.
Comme PackageUpdating et PackageUninstalling, cet événement transmet uniquement le package qui est status modifié. Il vous incombe de faire correspondre le package aux AppExtensions que vous avez chargés pour déterminer les extensions affectées par la modification status.