Partager via


Comment ClickOnce effectue des mises à jour d’application

ClickOnce utilise les informations de version de fichier spécifiées dans le manifeste de déploiement d’une application pour décider s’il faut mettre à jour les fichiers de l’application. Une fois la mise à jour commencée, ClickOnce utilise une technique appelée mise à jour corrective de fichiers pour éviter le téléchargement redondant de fichiers d’application.

Mise à jour corrective des fichiers

Lors de la mise à jour d’une application, ClickOnce ne télécharge pas tous les fichiers de la nouvelle version de l’application, sauf si les fichiers ont changé. Au lieu de cela, il compare les signatures de hachage des fichiers spécifiés dans le manifeste de l’application actuelle par rapport aux signatures du manifeste pour la nouvelle version. Si les signatures d’un fichier sont différentes, ClickOnce télécharge la nouvelle version. Si les signatures correspondent, le fichier n’a pas changé d’une version à l’autre. Dans ce cas, ClickOnce copie le fichier existant et l’utilise dans la nouvelle version de l’application. Cette approche empêche ClickOnce de devoir télécharger l’ensemble de l’application, même si un ou deux fichiers ont changé.

La mise à jour corrective de fichiers fonctionne également pour les assemblies téléchargés à la demande à l’aide des méthodes DownloadFileGroup et DownloadFileGroupAsync.

Note

La classe ApplicationDeployment et les API de l’espace de noms System.Deployment.Application ne sont pas prises en charge dans .NET Core et .NET 5 et les versions ultérieures. Dans .NET 7, une nouvelle méthode d’accès aux propriétés de déploiement d’application est prise en charge. Pour plus d’informations, consultez les propriétés de déploiement Access ClickOnce dans .NET. .NET 7 ne prend pas en charge l’équivalent des méthodes ApplicationDeployment.

Si vous utilisez Visual Studio pour compiler votre application, elle génère de nouvelles signatures de hachage pour tous les fichiers chaque fois que vous régénérez l’ensemble du projet. Dans ce cas, tous les assemblys sont téléchargés sur le client, même si seuls quelques assemblys peuvent avoir changé.

La mise à jour corrective des fichiers ne fonctionne pas pour les fichiers marqués comme des données et stockés dans le répertoire de données. Elles sont toujours téléchargées indépendamment de la signature de hachage du fichier. Pour plus d’informations sur le répertoire de données, consultez Accéder aux données locales et distantes dans les applications ClickOnce.