PackageCatalog.OpenForPackage(Package) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Permet d’écouter n’importe quel package et ses dépendants (facultatif, ressource et 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
Paramètres
- package
- Package
Package qui sera surveillé pour les notifications.
Retours
PackageCatalog utilisé pour écouter les notifications de déploiement.
Configuration requise pour Windows
Famille d’appareils |
Windows 11 Insider Preview (introduit dans 10.0.23504.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v15.0)
|
Exemples
Cet exemple utilise la méthode OpenForPackage pour écouter les notifications sur le package actuel (Package.Current). Le gestionnaire d’événements agit sur tout package facultatif qui a terminé la mise à jour.
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.");
}
}
Remarques
Cette API nécessite la fonctionnalité PackageQuery (sauf si l’appel concerne le package actuel).
Cette API permet à un package d’écouter les notifications de déploiement d’un autre package et de ses dépendants (comme les PWA).