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