ClickOnce et paramètres d'application

Les paramètres d'application des Windows Forms facilitent la création, le stockage et la gestion d'applications personnalisées et de préférences utilisateur sur l'ordinateur client. Le présent document décrit le fonctionnement des fichiers des paramètres de l'application dans une application ClickOnce et la procédure de migration des paramètres appliquée par ClickOnce lorsque l'utilisateur exécute une mise à niveau vers la version suivante.

Les informations suivantes concernent uniquement le fournisseur de paramètres d'application par défaut, la classe LocalFileSettingsProvider. Si vous utilisez un fournisseur personnalisé, ce fournisseur détermine la façon dont il stocke ses données et met à niveau ses paramètres d'une version à une autre. Pour plus d'informations sur les fournisseurs de paramètres d'application, consultez Architecture des paramètres d'application.

Fichiers des paramètres de l'application

Les paramètres d'application consomment deux fichiers : app.exe.config et user.config, où app correspond au nom de votre application Windows Forms. user.config est créé sur le client la première fois que votre application stocke des paramètres de portée utilisateur. En revanche, app.exe.config existera avant le déploiement si vous définissez des valeurs par défaut pour les paramètres. Visual Studio inclut automatiquement ce fichier lorsque vous utilisez sa commande Publier. Si vous créez votre application ClickOnce à l'aide de l'outil Mage.exe ou MageUI.exe, vous devez vous assurer que ce fichier est inclus avec les autres fichiers de votre application lorsque vous remplissez votre manifeste d'application.

Dans une application Windows Forms qui n'est pas déployée par ClickOnce, le fichier app.exe.config est stocké dans le répertoire de l'application, tandis que le fichier user.config est stocké dans le dossier Documents and Settings de l'utilisateur. Dans une application ClickOnce, app.exe.config figure dans le répertoire de l'application au sein du cache d'application ClickOnce, et user.config dans le répertoire de données ClickOnce pour cette application.

Indépendamment de la façon dont vous déployez votre application, les paramètres de l'application garantissent un accès en lecture sécurisé à app.exe.config ainsi qu'un accès en lecture/écriture sécurisé à user.config.

Dans une application ClickOnce, la taille des fichiers de configuration utilisés par les paramètres de l'application est limitée par la taille du cache ClickOnce. Pour plus d'informations, consultez Vue d'ensemble du cache ClickOnce.

Mise à niveau de version

De la même façon que chaque version d'une application ClickOnce est isolée des autres versions, les paramètres d'une application ClickOnce sont également isolés des paramètres des autres versions. Lorsque votre utilisateur effectue une mise à niveau vers une version ultérieure de votre application, les paramètres de l'application comparent les paramètres de la version la plus récente (identifiée par un numéro de version supérieur) aux paramètres fournis avec la version mise à jour et fusionnent les paramètres dans un nouveau jeu de fichiers de paramètres.

Le tableau suivant décrit comment les paramètres de l'application déterminent les paramètres à copier.

Type de modification	Action de mise à niveau
Paramètre ajouté au fichier app.exe.config	Le nouveau paramètre est fusionné dans le fichier app.exe.config de la version en cours.
Paramètre supprimé du fichier app.exe.config	L'ancien paramètre est supprimé du fichier app.exe.config de la version en cours.
Modification de la valeur par défaut du paramètre ; paramètre local toujours affecté de la valeur par défaut d'origine dans le fichier user.config	Le paramètre est fusionné dans le fichier user.config de la version actuelle avec la nouvelle valeur par défaut comme valeur.
Modification de la valeur par défaut du paramètre ; paramètre affecté d'une valeur autre que celle par défaut dans le fichier user.config	Le paramètre est fusionné dans le fichier user.config de la version actuelle en conservant la valeur non définie par défaut.

Si vous avez créé votre propre classe wrapper des paramètres de l'application et que vous souhaitez personnaliser la logique de mise à jour, vous pouvez substituer la méthode Upgrade.

ClickOnce et paramètres itinérants

ClickOnce ne fonctionne pas avec des paramètres itinérants, lesquels vous permettent de conserver votre fichier de paramètres d'un ordinateur à l'autre sur le réseau. Si vous avez besoin des paramètres itinérants, vous devez implémenter un fournisseur de paramètres d'application qui stocke des paramètres sur le réseau ou développer vos propres classes de paramètres personnalisées pour stocker des paramètres sur un ordinateur distant. Pour plus d'informations sur les fournisseurs de paramètres, consultez Architecture des paramètres d'application.

Voir aussi

Concepts

Sécurité et déploiement ClickOnce

Vue d'ensemble des paramètres d'application

Vue d'ensemble du cache ClickOnce

Accès aux données locales et distantes dans les applications ClickOnce