PackageExtensionCatalog.PackageStatusChanged イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カタログ内の拡張機能パッケージが削除、更新、またはインストールされたときに発生するイベント。
// 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 をチェックし、このような状況に対して特別な処理を提供できます。 通常、パッケージの状態が [OK] でない場合は、無効にする必要があります。 拡張機能を読み込もうとするときはいつでも PackageStatus.VerifyIsOk を呼び出すのが良い方法です。
このイベントを処理して、拡張機能が無効になっているか、パッケージに問題があるために使用できないというインジケーターを拡張機能マネージャー UI に提供することを検討してください。
ユーザーがパッケージを更新し、読み込むには OK になる可能性があるため、パッケージに問題があることを確認した場合でも、このイベントを処理し続けます。
PackageUpdating や PackageUninstalling と同様に、このイベントは、変更された状態の Package のみを渡します。 パッケージを読み込んだ PackageExtensions と照合して、状態の変更の影響を受ける拡張機能を判断するのはユーザーの判断です。