PackageExtensionCatalog.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 du catalogue a été supprimé, mis à jour ou installé.
// Register
event_token PackageStatusChanged(TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageStatusChangedEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageStatusChanged(event_token const* cookie) const;
// Revoke with event_revoker
PackageExtensionCatalog::PackageStatusChanged_revoker PackageStatusChanged(auto_revoke_t, TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageStatusChangedEventArgs const&> const& handler) const;
public event TypedEventHandler<PackageExtensionCatalog,PackageExtensionPackageStatusChangedEventArgs> PackageStatusChanged;
function onPackageStatusChanged(eventArgs) { /* Your code */ }
packageExtensionCatalog.addEventListener("packagestatuschanged", onPackageStatusChanged);
packageExtensionCatalog.removeEventListener("packagestatuschanged", onPackageStatusChanged);
- or -
packageExtensionCatalog.onpackagestatuschanged = onPackageStatusChanged;
Public Custom Event PackageStatusChanged As TypedEventHandler(Of PackageExtensionCatalog, PackageExtensionPackageStatusChangedEventArgs)
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 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 de 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 êtes certain qu’il existe un problème avec un package, car l’utilisateur peut mettre à jour le package et il peut alors être ok pour charger.
Comme PackageUpdating et PackageUninstalling, cet événement transmet uniquement le Package avec un status qui a été modifié. Il vous appartient de faire correspondre le package aux PackageExtensions que vous avez chargées pour déterminer quelles extensions sont affectées par la modification status.