PackageManager.RemovePackageAsync(String) | removePackageAsync(String) Method

Supprime un package pour l'utilisateur actuel de façon asynchrone et reçoit des messages de progression et d'état sur l'opération de suppression. Les packages de dépendance sont également supprimés pour l'utilisateur si aucun autre package installé pour l'utilisateur n'est interdépendant.

Syntaxe


packageManager.removePackageAsync(packageFullName).done( /* Vos gestionnaires de succès et d'erreurs */ );

Paramètres

packageFullName

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Représentation sous forme de chaîne de l'identité de package pour identifier le package à supprimer.

Valeur de retour

Type: IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress>

État de la demande de déploiement. DeploymentResult contient la valeur finale retournée de l'opération de déploiement, une fois qu'elle est terminée. DeploymentProgress peut être utilisé pour obtenir le pourcentage de réalisation sur l'ensemble de l'opération de déploiement.

Remarques

Cette requête ne peut pas être annulée. Le nom complet du package est une autre forme de l'identité de package qui est plus courte et adaptée pour nommer des objets tels que des fichiers et des dossiers. Une identité du module est représentée par l'élément Identity du manifeste du package. Lorsqu'un package est supprimé, il est supprimé pour l'utilisateur actuel, ce qui signifie que la charge du package continue d'exister si d'autres utilisateurs ont installé le package, mais elle n'est pas accessible à l'utilisateur actuel. Si aucun autre utilisateur n'a installé le package spécifié, sa charge est supprimée du répertoire %ProgramFiles%\WindowsApps. Toute application associée au package en cours de suppression sera arrêtée automatiquement dans le cadre de la suppression du package.

Exemples

Appelez la méthode RemovePackageAsync(String) pour désinstaller le package d'application. Notez que le nom complet du package dans packageFullName provient d'un argument de ligne de commande.

RemovePackageAsync(String) retourne un objet qui peut être utilisé pour gérer l'opération asynchrone. La propriété Completed permet de définir le délégué. Vérifiez la propriété Status pour déterminer l'état de l'opération de déploiement. Si l'état est Error, l'exemple appelle la méthode GetResults pour obtenir des informations supplémentaires sur l'erreur.



using Windows.Foundation;
using Windows.Management.Deployment;

[STAThread]
public static int Main(string[] args)
{
    string inputPackageFullName = args[0];
    int returnValue = 0;

    PackageManager packageManager = new Windows.Management.Deployment.PackageManager();

    IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> deploymentOperation = 
        packageManager.RemovePackageAsync(inputPackageFullName);
    // This event is signaled when the operation completes
    ManualResetEvent opCompletedEvent = new ManualResetEvent(false); 

    // Define the delegate using a statement lambda
    deploymentOperation.Completed = (depProgress, status) => { opCompletedEvent.Set(); };

    // Wait until the operation completes
    opCompletedEvent.WaitOne();

    // Check the status of the operation
    if (deploymentOperation.Status == AsyncStatus.Error)
    {
        DeploymentResult deploymentResult = deploymentOperation.GetResults();
        Console.WriteLine("Error code: {0}", deploymentOperation.ErrorCode);
        Console.WriteLine("Error text: {0}", deploymentResult.ErrorText);
        returnValue = 1;
    }
    else if (deploymentOperation.Status == AsyncStatus.Canceled)
    {
        Console.WriteLine("Removal canceled");
    }
    else if (deploymentOperation.Status == AsyncStatus.Completed)
    {
        Console.WriteLine("Removal succeeded");
    }
    else
    {
        returnValue = 1;
        Console.WriteLine("Removal status unknown");
    }

    return returnValue;
}

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.Management.Deployment
Windows::Management::Deployment [C++]

Métadonnées

Windows.winmd

Voir aussi

PackageManager
RemovePackageAsync(String, RemovalOptions)

 

 

Afficher:
© 2014 Microsoft