PackageCatalog.OpenForPackage(Package) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позволяет прослушивать любой пакет и его зависимые элементы (необязательно, ресурс и hostRuntime).
public:
static PackageCatalog ^ OpenForPackage(Package ^ package);
static PackageCatalog OpenForPackage(Package const& package);
public static PackageCatalog OpenForPackage(Package package);
function openForPackage(package)
Public Shared Function OpenForPackage (package As Package) As PackageCatalog
Параметры
- package
- Package
Пакет, который будет отслеживаться для получения уведомлений.
Возвращаемое значение
PackageCatalog, используемый для прослушивания уведомлений о развертывании.
Требования к Windows
Семейство устройств |
Windows 11 Insider Preview (появилось в 10.0.23504.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v15.0)
|
Примеры
В этом примере используется метод OpenForPackage для прослушивания уведомлений о текущем пакете (Package.Current). Обработчик событий работает с любым необязательным пакетом, который завершил обновление.
void RegisterForDeploymentNotifications()
{
if (catalog == null)
{
catalog = PackageCatalog.OpenForPackage(Package.Current);
catalog.PackageUpdating += OptionalPackageUpdatingCallback;
}
}
void OptionalPackageUpdatingCallback(object sender, PackageUpdatingEventArgs args)
{
if (args.IsComplete && args.TargetPackage.IsOptional)
{
// Let the user know the Optional package has updated, and can be used now
var messageDialog = new MessageDialog(args.TargetPackage.DisplayName +
" has been updated. Please restart the app to enjoy our latest features.");
}
}
Комментарии
Для этого API требуется возможность PackageQuery (если вызов не предназначен для текущего пакета).
Этот API позволяет пакету прослушивать уведомления о развертывании для другого пакета и его зависимых элементов (например, PWA).