PackageCatalog.OpenForPackage(Package) Método

Definição

Namespace:

Windows.ApplicationModel

Permite escutar qualquer Pacote e seus dependentes (opcional, recurso e 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

Parâmetros

package

Package

O Pacote que será monitorado para notificações.

Retornos

PackageCatalog

O PackageCatalog usado para escutar notificações de implantação.

Requisitos do Windows

Família de dispositivos	Windows 11 Insider Preview (introduzida na 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v15.0)

Exemplos

Este exemplo usa o método OpenForPackage para escutar notificações no pacote atual (Package.Current). O manipulador de eventos atua em qualquer pacote opcional que tenha terminado de atualizar.

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

Comentários

Essa API requer a funcionalidade PackageQuery (a menos que a chamada seja para o pacote atual).

Essa API permite que um pacote ouça as notificações de implantação de outro pacote e seus dependentes (como PWAs).

Confira também

• OpenForCurrentPackage()
• Package
• PackageCatalog