AppExtensionCatalog.PackageInstalled Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Evento generato quando viene installato un pacchetto di estensione.
// Register
event_token PackageInstalled(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;
// Revoke with event_revoker
AppExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageInstalledEventArgs> PackageInstalled;function onPackageInstalled(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
appExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
appExtensionCatalog.onpackageinstalled = onPackageInstalled;Public Custom Event PackageInstalled As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageInstalledEventArgs) Tipo evento
Commenti
L'argomento evento AppExtensionPackageInstalledEventArgs.Extensions contiene un elenco di estensioni all'interno del pacchetto di estensione.
Le estensioni sono definite <uap3:AppExtension Name=...> nel file Package.appxmanifest dell'estensione. Solo le estensioni che corrispondono a <uap3:AppExtension Name=...> definite nel file Package.appxmanifest dell'host sono incluse nell'elenco delle estensioni.
Un gestore eventi per questo evento è un buon posto per esaminare ogni estensione dell'app per verificare la correttezza e fornire all'utente la possibilità di usarla.
L'unità di distribuzione per un'appExtension è il pacchetto. Ecco perché si tratta di un evento di installazione del pacchetto e non di un evento di installazione AppExtension .
In genere, in un pacchetto sarà presente una sola estensione. Tuttavia, essere pronti a gestire il caso in cui sono presenti più estensioni nel pacchetto.
Usare AppExtension.Id per distinguere le estensioni nello stesso pacchetto. Per identificare in modo univoco un'estensione nell'app, è consigliabile concatenare AppInfo.AppUserModelId e AppExtension.Id:
_uniqueId = yourAppExtention.AppInfo.AppUserModelId + "!" + yourAppExtention.Id;
Ciò garantisce che ogni AppExtension abbia un nome univoco che puoi usare per tenerlo traccia nella tua app. È consigliabile usarlo come chiave per le appExtensions in modo che sia possibile identificare in modo efficiente e corretto se un'appExtension specifica è già nota.