PackageExtensionCatalog.PackageInstalled Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Событие, возникающее при установке пакета расширения.
// Register
event_token PackageInstalled(TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;
// Revoke with event_revoker
PackageExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs const&> const& handler) const;
public event TypedEventHandler<PackageExtensionCatalog,PackageExtensionPackageInstalledEventArgs> PackageInstalled;
function onPackageInstalled(eventArgs) { /* Your code */ }
packageExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
packageExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
packageExtensionCatalog.onpackageinstalled = onPackageInstalled;
Public Custom Event PackageInstalled As TypedEventHandler(Of PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs)
Тип события
Комментарии
Аргумент события PackageExtensionPackageInstalledEventArgs.Extensions содержит список расширений в пакете расширений.
Область расширения определяется <uap17:PackageExtension Name=...>
в файле Package.appxmanifest расширения. В списке расширений находятся только расширения, которые соответствуют <uap17:PackageExtension Name=...>
определенному в файле Package.appxmanifest узла.
Обработчик событий для этого события является хорошим местом для проверки правильности каждого расширения пакета и предоставления пользователю возможности его использования.
Единицей развертывания для PackageExtension является Package. Поэтому это событие установки пакета , а не событие установки PackageExtension .
Обычно в пакете имеется только одно расширение. Однако будьте готовы к обработке ситуации, когда в пакете есть несколько расширений.
Используйте PackageExtension.Id , чтобы различать расширения в одном пакете. Чтобы уникально определить расширение в пакете, рассмотрите возможность объединения Package.Id и PackageExtension.Id:
_uniqueId = yourPackageExtension.Package.Id + "|" + yourPackageExtension.Id;
Это гарантирует, что каждое packageExtension имеет уникальное имя, которое можно использовать для его отслеживания. Мы рекомендуем использовать его в качестве ключа к расширению packageExtensions , чтобы вы могли эффективно и правильно определить, является ли данный PackageExtension уже знакомым.