Procédure : Lire des paramètres d’application
Remarque
Cet article est spécifique au .NET Framework. Ceci ne s’applique pas aux implémentations plus récentes de .NET, y compris .NET 6 et versions ultérieures.
Cet article explique comment ajouter un paramètre simple à un fichier App.config dans une application .NET Framework, puis lire la valeur par programmation. Au lieu de lire une seule valeur, vous pouvez lire une section entière ou l’intégralité du fichier. Pour plus d’informations et d’exemples, consultez la documentation ConfigurationManager.
Ajouter le fichier App.config
Visual Studio facilite l’ajout d’un fichier App.config à votre projet. Après avoir créé un projet .NET Framework, cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions et sélectionnez Ajouter>Nouvel élément. Sélectionnez l’élément Fichier de configuration de l’application, puis Ajouter.
Ajouter un paramètre
Ouvrez le fichier App.config et ajoutez le code XML suivant dans l’élément <configuration>.
<appSettings>
<add key="occupation" value="dentist"/>
</appSettings>
Accéder au paramètre par programmation
Pour accéder à la valeur du paramètre dans votre code, obtenez la valeur en indexant dans la propriété AppSettings. La propriété AppSettings permet d’obtenir facilement des données à partir de l’élément <appSettings> de votre fichier de configuration.
string occupation = ConfigurationManager.AppSettings["occupation"];
Configuration des bibliothèques
Bien qu’il soit simple d’utiliser des fichiers de configuration pour les applications exécutables, cela se révèle un peu plus complexe pour les bibliothèques de classes. Les bibliothèques de classes peuvent accéder aux paramètres de configuration de la même manière que les applications exécutables. Toutefois, les paramètres de configuration doivent être présents dans le fichier App.config de l’application cliente. Même si vous distribuez un fichier App.config en même temps que le fichier d’assembly de votre bibliothèque, le code de la bibliothèque ne lit pas ce fichier. Vous pouvez également envisager de procéder comme suit pour utiliser les paramètres de configuration dans une bibliothèque de classes :
- Obtenez les paramètres de configuration dans l’application cliente et transmettez-les à la classe que vous instanciez à partir de la bibliothèque de classes.
- Implémentez un type de section personnalisé qui étend la classe ConfigurationSection. Conservez un fichier de configuration distinct pour votre bibliothèque de classes, puis référencez le fichier de configuration de la bibliothèque à partir du fichier de configuration de l’application cliente. Pour plus d’informations, consultez Procédure : Créer des sections de configuration personnalisées à l’aide de ConfigurationSection.
