AppExtensionCatalog.PackageStatusChanged Evento

Definição

Namespace:

Windows.ApplicationModel.AppExtensions

Evento que é acionado quando um pacote de extensão no catálogo é removido, atualizado ou instalado.

// 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) 

Tipo de evento

TypedEventHandler<AppExtensionCatalog,AppExtensionPackageStatusChangedEventArgs>

Comentários

Esse evento ajuda você a identificar quando um pacote não está mais disponível, válido ou foi modificado. Manipule esse evento para determinar quando uma extensão pode não ser mais válida e deve ser desabilitada. Um uso comum para esse evento é detectar se o pacote do aplicativo que fornece a extensão está instalado em mídia removível. Se o usuário remover a mídia que contém o pacote, esse evento será gerado para esse pacote.

A classe PackageStatus fornece o possível pacote status estados. Use PackageStatus.VerifyIsOk para determinar se o pacote está em boas condições. Se ele retornar false, você poderá marcar PackageStatus.LicenseIssue ou PackageStatus.PackageOffline e fornecer tratamento especial para essas situações. Normalmente, se o estado do pacote não for Ok, você deverá desabilitá-lo. É uma boa prática chamar PackageStatus.VerifyIsOk sempre que você estiver prestes a carregar uma extensão.

Considere lidar com esse evento para fornecer um indicador na interface do usuário do gerenciador de extensões de que a extensão está desabilitada ou não utilizável porque há algo errado com o pacote.

Continue a lidar com esse evento, mesmo que você tenha determinado que há um problema com um pacote, pois o usuário pode atualizar o pacote e, em seguida, pode ser ok carregar.

Assim como PackageUpdating e PackageUninstalling, esse evento passa apenas o Pacote status alterado. Cabe a você corresponder o Pacote às AppExtensions que você carregou para determinar quais extensões são afetadas pelo status alteração.