Partager via

<appSettings> élément pour <la configuration>

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

<Configuration>
   <appSettings>

Syntaxe

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

Caractéristique

Descriptif
file Attribut facultatif.

Spécifie un chemin d’accès relatif à un 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 <add>éléments et <remove><clear> 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 de l’application. Pour les applications Web Forms, le chemin d’accès est relatif à la racine de l’application, où se trouve le fichier web.config .

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

Élément parent

Descriptif
<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

Descriptif
<ajouter> Ajoute un paramètre d’application personnalisé.
<clair> Efface tous les paramètres d’application précédemment définis.
<enlever> Supprime un paramètre d’application précédemment défini.

Remarques

L’élément <appSettings> stocke des informations de configuration d’application personnalisées, telles que des chaînes de connexion de base de données, des chemins d’accès de fichier, 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 sont accessibles dans le code à l’aide <appSettings> de la ConfigurationSettings classe.

Vous pouvez utiliser l’attribut file dans l’élément <appSettings> des fichiers de configurationWeb.config et d’application. 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 les scénarios de développement d’équipe de contrôle de code source, par exemple lorsqu’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 au lieu <appSettings>de <configuration> .

Example

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 de son 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 fichiersWeb.config qui ne sont pas au niveau du répertoire de l’application.

Voir aussi

  • Last updated on