PackageCatalog.OpenForPackage(Package) 方法

定义

命名空间:

Windows.ApplicationModel

允许侦听任何 包 及其依赖项 (可选、资源和 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

用于侦听部署通知的 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) ）的部署通知。

另请参阅

• OpenForCurrentPackage()
• Package
• PackageCatalog