PackageExtensionCatalog.PackageStatusChanged Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Событие, возникающее при удалении, обновлении или установке пакета расширения в каталоге.
// 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) Тип события
Комментарии
Это событие помогает определить, когда пакет больше недоступен, действителен или изменен. Обработайте это событие, чтобы определить, когда расширение может быть недействительным и должно быть отключено. Обычно это событие используется для определения того, установлен ли пакет, предоставляющий расширение, на съемном носителе. Если пользователь удаляет носитель, содержащий пакет, для этого пакета возникает это событие.
Класс PackageStatus предоставляет возможные состояния состояния пакета.
Используйте PackageStatus.VerifyIsOk , чтобы определить, находится ли пакет в хорошем состоянии. Если возвращается значение false, можно проверка PackageStatus.LicenseIssue или PackageStatus.PackageOffline и обеспечить специальную обработку для этих ситуаций. Как правило, если пакет находится в состоянии не в порядке, его следует отключить. Рекомендуется вызывать PackageStatus.VerifyIsOk при загрузке расширения.
Рассмотрите возможность обработки этого события для предоставления индикатора в пользовательском интерфейсе диспетчера расширений о том, что расширение отключено или недоступно, так как с пакетом что-то не так.
Продолжайте обрабатывать это событие, даже если вы уверены, что с пакетом возникла проблема, так как пользователь может обновить пакет и загрузить его.
Как и PackageUpdating и PackageUninstalling, это событие передает только пакет с измененным состоянием. Чтобы определить, на какие расширения влияет изменение состояния, необходимо сопоставить пакет с загруженными расширениями.