Package.CheckUpdateAvailabilityAsync Méthode

public:
 virtual IAsyncOperation<PackageUpdateAvailabilityResult ^> ^ CheckUpdateAvailabilityAsync() = CheckUpdateAvailabilityAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PackageUpdateAvailabilityResult> CheckUpdateAvailabilityAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PackageUpdateAvailabilityResult> CheckUpdateAvailabilityAsync();

function checkUpdateAvailabilityAsync()

Public Function CheckUpdateAvailabilityAsync () As IAsyncOperation(Of PackageUpdateAvailabilityResult)

Retours

PackageUpdateAvailabilityResult qui indique si une application a une mise à jour et si la mise à jour est requise.

Attributs

RemoteAsyncAttribute

Configuration requise pour Windows

Exemples

Un développeur d’applications souhaite avoir un bouton dans son application qui permet à un utilisateur de case activée pour les mises à jour de l’application. Pour permettre à l’application de case activée si une mise à jour est disponible, ils utilisent la CheckUpdateAvailabilityAsync méthode comme indiqué ci-dessous.

private async void CheckForUpdatesButton_Click(object sender, RoutedEventArgs e)
{
    // Get the current app's package for the current user.
    var pm = new PackageManager();
    Package currentPackage = pm.FindPackageForUser(string.Empty, Package.Current.Id.FullName);

    PackageUpdateAvailabilityResult result = await currentPackage.CheckUpdateAvailabilityAsync();
    switch (result.Availability)
    {
        case PackageUpdateAvailability.Available:
            GoToUpdateAvailableUIView();
            break;
        case PackageUpdateAvailability.Required:
            GoToUpdateRequiredUIView();
            break;
        case PackageUpdateAvailability.NoUpdates:
            // Dismissable ‘Ok’ dialog.
            ShowNoUpdateAvailableDialog(); 
            break;
        case PackageUpdateAvailability.Unknown:
        default:
            // Log and ignore error.
            Logger.Log($"No update information associated with app {Package.Current.DisplayName}");
            // Dismissable ‘Ok’ dialog.
            ShowNoUpdateAvailableDialog();
            break;
    }
}

À partir de l’application, le développeur souhaite case activée pour les mises à jour et démarrer le processus de mise à jour si des mises à jour sont disponibles.

public async void CheckForAvailableUpdatesAndLaunchAsync(string targetPackageFullName)
{
    // Get the current app's package for the current user.
    var pm = new PackageManager();
    Package package = pm.FindPackageForUser(string.Empty, targetPackageFullName);

    PackageUpdateAvailabilityResult result = await package.CheckUpdateAvailabilityAsync();
    switch (result.Availability)
    {
        case PackageUpdateAvailability.Available:
            GoToUpdateAvailableUIView();
            break;
        case PackageUpdateAvailability.Required:
            GoToUpdateRequiredUIView();
            break;
        case PackageUpdateAvailability.NoUpdates:
            // Launch target app and close AppInstaller.
            LaunchTargetApp(targetPackageFullName);
            await ConsolidateAppInstallerView();
            break;
        case PackageUpdateAvailability.Unknown:
        default:
            // Log and ignore error.
            Logger.Log($"No update information associated with app {targetPackageFullName}");
            // Launch target app and close AppInstaller.
            LaunchTargetApp(targetPackageFullName);
            await ConsolidateAppInstallerView();
            break;
    }
}

Remarques

Si vous essayez d’utiliser cette méthode sur l’objet Package retourné par la propriété Current , cette méthode échoue avec une erreur « Accès refusé ». Il s’agit d’un problème connu qui peut être résolu dans une version ultérieure. L’exemple de cette page montre comment récupérer des informations de mise à jour sur le package de l’application actuelle.

Cette méthode n’est pas prise en charge dans JavaScript. Toutefois, vous pouvez créer un composant Windows Runtime qui appelle cette méthode, puis appeler ce composant à partir d’une application UWP JavaScript. Pour plus d’informations, consultez Problèmes d’API du fichier du programme d’installation d’application.

S’applique à

Voir aussi

• PackageUpdateAvailabilityResult
• FindPackageForUser(String, String)
• API du programme d’installation d’application