PackageCatalog.OpenForPackage(Package) Methode

Referenz

Definition

Namespace:: Windows.ApplicationModel

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ermöglicht das Lauschen auf jedes Paket und seine abhängigen Elemente (optional, resource und 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

Parameter

package: Package

Das Paket , das auf Benachrichtigungen überwacht wird.

Gibt zurück

PackageCatalog

Der PackageCatalog , der verwendet wird, um auf Bereitstellungsbenachrichtigungen zu lauschen.

Windows-Anforderungen

Gerätefamilie	Windows 11 Insider Preview (eingeführt in 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v15.0)

Beispiele

In diesem Beispiel wird die OpenForPackage-Methode verwendet, um auf Benachrichtigungen für das aktuelle Paket (Package.Current) zu lauschen. Der Ereignishandler wirkt auf jedes optionale Paket, das die Aktualisierung abgeschlossen hat.

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.");
    }
}

Hinweise

Diese API erfordert die PackageQuery-Funktion (es sei denn, der Aufruf erfolgt für das aktuelle Paket).

Mit dieser API kann ein Paket bereitstellungsbenachrichtigungen für ein anderes Paket und dessen abhängige Elemente (z. B. PWAs) überwachen.

Gilt für:

Freigeben über