Guide pratique pour lire les paramètres de l’application

2025-06-17

Remarque

Cet article est spécifique à .NET Framework. Elle ne s’applique pas aux implémentations plus récentes de .NET, notamment .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’exemples et d’informations, consultez la ConfigurationManager documentation.

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 choisissez Ajouter>un nouvel élément. Choisissez l’élément Fichier de configuration de l’application , puis sélectionnez 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 AppSettings propriété. La AppSettings propriété facilite l’obtention de 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, il est un peu plus compliqué pour les bibliothèques de classes. Les bibliothèques de classes peuvent accéder aux paramètres de configuration de la même façon que les applications exécutables. Toutefois, les paramètres de configuration doivent exister 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 le fichier. Vous pouvez également envisager les méthodes suivantes pour utiliser les paramètres de configuration dans une bibliothèque de classes :

Obtenez les paramètres de configuration dans l’application cliente et passez-les à la classe que vous instanciez à partir de la bibliothèque de classes.
Implémentez un type de section personnalisé qui étend la ConfigurationSection classe. 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 Guide pratique pour créer des sections de configuration personnalisées à l’aide de ConfigurationSection.

Voir aussi

System.Configuration.ConfigurationManager