Partager via

Élément <appSettings> pour <configuration>

  • Article

Efface les paramètres d’application personnalisés. Il s’agit d’une section de configuration prédéfinie fournie par .NET Framework.

<configuration>
  <appSettings>

Syntaxe

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

Attribut

Description
file Attribut facultatif.

Spécifie un chemin relatif de fichier externe contenant des paramètres de configuration d’application personnalisés. Le fichier spécifié contient le même type de paramètres que ceux spécifiés dans les éléments <add>, <remove> et <clear> et utilise le même format de paire clé/valeur que ces éléments.

Le chemin spécifié est relatif au fichier de configuration principal. Pour une application Windows Forms, il s’agit du dossier binaire (tel que /bin/debug) et non de l’emplacement du fichier de configuration d’application. Pour les applications Web Forms, le chemin est relatif à la racine de l’application, où se trouve le fichier web.config.

Le runtime ignore l’attribut de fichier si le fichier spécifié est introuvable.

Élément parent

Description
<configuration> Élément Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

Éléments enfants

Description
<add> Ajoute un paramètre d’application personnalisé.
<clear> Efface tous les paramètres d’application précédemment définis.
<remove> Efface un paramètre d’application précédemment défini.

Notes

L’élément <appSettings> stocke les informations de configuration d’application personnalisées, telles que des chaînes de connexion de base de données, des chemins de fichiers, des URL de service web XML ou d’autres informations de configuration personnalisées pour une application. Les paires clé/valeur spécifiées dans l’élément <appSettings> sont accessibles dans le code en utilisant la classe ConfigurationSettings.

Vous pouvez utiliser l’attribut file dans l’élément <appSettings> des fichiers de configuration d’application et Web.config. Cet attribut spécifie un fichier de configuration qui fournit des paramètres supplémentaires ou remplace les paramètres spécifiés dans l’élément <appSettings>. L’attribut file peut être utilisé dans des scénarios de développement d’équipe de contrôle de code source, par exemple quand un utilisateur souhaite remplacer les paramètres de projet spécifiés dans un fichier de configuration d’application.

Les fichiers de configuration spécifiés par l’attribut file doivent avoir un nœud racine <appSettings> et non <configuration>.

Exemple

L’exemple suivant montre un fichier de paramètres d’application externe (custom.config) qui définit un paramètre d’application personnalisé :

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

L’exemple suivant montre un fichier de configuration d’application qui consomme le paramètre dans le fichier de paramètres externes et définit un paramètre d’application qui lui est propre :

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

Fichier de configuration

Cet élément peut être utilisé dans le fichier de configuration de l’application, le fichier de configuration de l’ordinateur (Machine.config) et les fichiers Web.config qui ne sont pas au niveau du répertoire de l’application.

Voir aussi