Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les paramètres d’application pour Windows Forms facilitent la création, le stockage et la gestion des préférences personnalisées des applications et des utilisateurs sur le client. Le document suivant décrit comment fonctionnent les fichiers de paramètres d’application dans une application ClickOnce et comment ClickOnce migre les paramètres lorsque l’utilisateur effectue une mise à niveau vers la version suivante.
Les informations ci-dessous s’appliquent uniquement au fournisseur de paramètres d’application par défaut, la LocalFileSettingsProvider classe. Si vous fournissez un fournisseur personnalisé, ce fournisseur détermine comment il stocke ses données et comment il met à niveau ses paramètres entre les versions. Pour plus d’informations sur les fournisseurs de paramètres d’application, consultez l’architecture des paramètres d’application.
Fichiers de paramètres d’application
Les paramètres d’application consomment deux fichiers : <.exe.configd’application> et user.config, où l’application est le nom de votre application Windows Forms. user.config est créé sur le client la première fois que votre application stocke les paramètres définis par l’utilisateur. <l’application>.exe.config, par opposition, existe 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 deMage.exe ou deMageUI.exe, vous devez vous assurer que ce fichier est inclus dans les autres fichiers de votre application lorsque vous remplissez votre manifeste d’application.
Note
Dans ClickOnce pour .NET Core 3.1 et .NET 5 ou version ultérieure, utilisez dotnet-mage.exe au lieu de Mage.exe. Pour plus d’informations, consultez ClickOnce pour .NET.
Dans une application Windows Forms non déployée à l’aide de ClickOnce, le fichier app<.exe.config de l'application 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, <l’application>.exe.config réside dans le répertoire de l’application à l’intérieur du cache de l’application ClickOnce, et user.config réside dans le répertoire de données ClickOnce pour cette application.
Quelle que soit la façon dont vous déployez votre application, les paramètres de l’application garantissent un accès en lecture sécurisé aux <.exe.configd’application>et 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 la vue d’ensemble du cache ClickOnce.
.NET Core et .NET 5+
Actuellement, un assembly .NET Core à publier doit être signé avec un fichier de clé de nom fort. Si ce n’est pas le cas, ApplicationSettingsBase.Upgrade la méthode ne copie pas correctement les paramètres après une nouvelle publication ClickOnce. Vous pouvez spécifier l’utilisation d’un nom fort dans les propriétés du projet .NET Core, sous l’option Générer > un nom fort .
Mises à niveau de la version
Tout comme chaque version d’une application ClickOnce est isolée de toutes les autres versions, les paramètres d’application 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 (numérotée la plus élevée) par rapport aux paramètres fournis avec la version mise à jour et fusionnent les paramètres dans un nouvel ensemble de fichiers de paramètres.
Le tableau suivant décrit comment les paramètres d’application déterminent les paramètres à copier.
| Type de modification | Action de mise à niveau |
|---|---|
| Paramètre ajouté à <l’application>.exe.config | Le nouveau paramètre est fusionné dans l'app< de la version actuelle>.exe.config |
| Paramètre supprimé du fichier <app>.exe.config | L’ancien paramètre est supprimé du fichier <app>.exe.config de la version actuelle. |
| La valeur par défaut du paramètre a été modifiée ; paramètre local toujours défini sur la valeur par défaut d’origine dans user.config | Le paramètre est fusionné dans la user.config de la version actuelle avec la nouvelle valeur par défaut comme valeur |
| La valeur par défaut du paramètre a été modifiée ; paramètre défini sur non par défaut dans user.config | Le paramètre est fusionné dans la user.config de la version actuelle avec la valeur non par défaut conservée |
Si vous avez créé votre propre classe wrapper des paramètres d’application et que vous souhaitez personnaliser la logique de mise à jour, vous pouvez remplacer la Upgrade méthode.
Paramètres ClickOnce et itinérance
ClickOnce ne fonctionne pas avec les paramètres d’itinérance, ce qui permet à votre fichier de paramètres de vous suivre sur des ordinateurs sur un réseau. Si vous avez besoin de paramètres itinérants, vous devez implémenter un fournisseur de paramètres d’application qui stocke les paramètres sur le réseau ou développer vos propres classes de paramètres personnalisées pour stocker les paramètres sur un ordinateur distant. Pour plus d’informations sur les fournisseurs de paramètres, consultez l’architecture des paramètres d’application.