Les paramètres d'application vous permettent de stocker et de récupérer dynamiquement des paramètres de propriété et d'autres informations pour votre application, tout en gérant l'application personnalisée et les préférences de l'utilisateur sur l'ordinateur client. Il s'agit généralement de données (telles qu'une chaîne de connexion) critiques pour l'exécution de l'application, que vous ne souhaitez pas inclure directement dans le code de l'application. Vous pouvez stocker deux chaînes de connexion différentes à une base de données et en récupérer une au moment de l'exécution selon l'emplacement de l'ordinateur. Ou bien vous pouvez stocker les préférences de couleur d'un utilisateur, puis les récupérer à la prochaine exécution de l'application.

Notez que les paramètres d'application sont une fonctionnalité Microsoft Visual Studio 2005 qui remplace la fonctionnalité des propriétés dynamiques dans la version antérieure (pour plus d'informations sur les propriétés dynamiques, consultez Configuration d'applications à l'aide de propriétés dynamiques).

Chaque paramètre d'application doit avoir un nom unique ; celui-ci peut être toute combinaison de lettres, de nombres ou de traits de soulignement, ne commençant pas par un nombre et ne contenant pas d'espaces. Le nom peut être modifié via la propriété Name.

Les paramètres d'application peuvent être stockés comme n'importe quel type de données sérialisable par XML ou ayant un TypeConverter qui implémente ToString/FromString. Les types les plus courants sont String, Integer et Boolean, mais vous pouvez également stocker des valeurs en tant que Color, Object ou chaîne de connexion.

Les paramètres d'application contiennent également une valeur. La valeur est définie avec la propriété Value et doit correspondre au type de données du paramètre.

De plus, les paramètres d'application peuvent être directement liés à une propriété d'un formulaire ou d'un contrôle au moment du design. Pour plus d'informations, consultez Comment : ajouter ou supprimer des paramètres d'application.

Selon la portée, on distingue deux types de paramètres d'application :

• Les paramètres de portée application peuvent être utilisés pour des informations telles qu'une URL pour un service Web ou une chaîne de connexion à une base de données. Ces valeurs sont associées à l'application, donc les utilisateurs ne peuvent pas les modifier au moment de l'exécution.

• Les paramètres de portée utilisateur peuvent être utilisés pour des informations telles que la remémoration de la dernière position d'un formulaire ou d'une préférence de police. Les utilisateurs peuvent modifier ces valeurs au moment de l'exécution.

Vous pouvez modifier le type d'un paramètre à l'aide de la propriété Scope.

Le système de projet stocke les paramètres d'application dans deux fichiers XML : un fichier app.config, créé au moment du design lorsque vous créez le premier paramètre d'application ; et un fichier user.config, créé au moment de l'exécution lorsque l'utilisateur qui exécute l'application modifie la valeur d'un paramètre utilisateur. Notez que les modifications apportées aux paramètres utilisateur ne sont pas écrites sur le disque, sauf si l'application appelle spécifiquement une méthode pour le faire.

Créer les paramètres d'application au moment du design

Au moment du design, vous pouvez créer des paramètres d'application de deux manières : avec la page Paramètres du Concepteur de projets ou avec la fenêtre Propriétés pour un formulaire ou un contrôle, ce qui vous permet de lier directement un paramètre à une propriété. Pour plus d'informations, consultez Comment : ajouter ou supprimer des paramètres d'application.

Lorsque vous créez un paramètre de portée application (par exemple, une chaîne de connexion à une base de données ou une référence aux ressources serveur), Visual Studio l'enregistre dans app.config avec la balise <applicationSettings> (les chaînes de connexion sont enregistrées sous la balise <connectionStrings>).

Lorsque vous créez un paramètre de portée utilisateur (par exemple, une police par défaut, une page d'accueil ou une taille de fenêtre), Visual Studio l'enregistre dans app.config avec la balise <userSettings>.

Remarque de sécurité

Lorsque vous stockez des chaînes de connexion dans app.config, vous devez prendre des précautions pour éviter de révéler des informations sensibles, telles que des mots de passe ou des chemins d'accès au serveur, dans la chaîne de connexion. Si vous obtenez une information de chaîne de connexion à partir d'une source externe, par exemple un utilisateur qui fournit un ID d'utilisateur et un mot de passe, vous devez veiller à ce que les valeurs utilisées pour construire votre chaîne de connexion ne contiennent pas de paramètres de chaîne de connexion supplémentaires qui modifient le comportement de votre connexion. Envisagez l'utilisation de la fonctionnalité de configuration protégée pour chiffrer les informations sensibles dans le fichier de configuration. Pour plus d'informations, consultez Sécurisation de chaînes de connexion.

Remarque
Étant donné qu'il n'y a aucun modèle de fichier de configuration pour les bibliothèques de classes, les paramètres d'application ne s'appliquent pas aux projets Bibliothèque de classes. L'exception est un projet de DLL Visual Studio Tools pour Office, qui peut avoir un fichier de configuration.

Accéder ou modifier les paramètres d'application au moment de l'exécution en Visual Basic

Remarque
Cette section s'applique uniquement aux projets Visual Basic.

Au moment de l'exécution, vous pouvez accéder aux paramètres d'application à l'aide de l'objet My.Settings. Sur la page Paramètres, cliquez sur le bouton Afficher le code pour afficher le fichier Settings.vb (pour plus d'informations, consultez Comment : accéder aux événements Settings). Settings.vb définit la classe Settings qui vous permet de gérer ces événements sur la classe de paramètres : SettingChanging, PropertyChanged, SettingsLoaded et SettingsSaving. Notez que la classe Settings dans Settings.vb est une classe partielle, qui affiche uniquement le code appartenant à l'utilisateur, non pas l'intégralité de la classe générée. Pour plus d'informations sur l'accès aux paramètres d'application à l'aide de l'objet My.Settings, consultez Accès aux paramètres d'application.

Les valeurs de tous les paramètres de portée utilisateur modifiés par l'utilisateur au moment de l'exécution (par exemple, la position d'un formulaire) sont stockées dans un fichier user.config. Notez que les valeurs par défaut restent enregistrées dans app.config.

Si vous avez modifié des paramètres de portée utilisateur au cours de l'exécution, en testant l'application par exemple, et souhaitez réinitialiser ces paramètres à leurs valeurs par défaut, cliquez sur le bouton Synchroniser. Pour plus d'informations sur ce contrôle, consultez Page Paramètres, Concepteur de projets.

Voir aussi