<appSettings>, élément

Article
04/11/2008

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

<appSettings file="relative file name">
</appSettings>

Attribut facultatif

Attribut	Description
file	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 qui sont 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 d'accès spécifié est un chemin relatif au fichier de configuration principal. Pour une application Windows Forms, il correspondrait au dossier binaire (par exemple /bin/debug) et non à 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. Notez que le runtime ignore l'attribut si le fichier spécifié ne peut pas être trouvé.

file

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 qui sont 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 d'accès spécifié est un chemin relatif au fichier de configuration principal. Pour une application Windows Forms, il correspondrait au dossier binaire (par exemple /bin/debug) et non à 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.

Notez que le runtime ignore l'attribut si le fichier spécifié ne peut pas être trouvé.

Éléments enfants

Élément	Description
<add>	Ajoute des paramètres d'application personnalisés.
<remove>	Supprime un paramètre d'application défini précédemment.
<clear>	Supprime tous les paramètres d'application définis précédemment.

Notes

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 aux fichiers, des URL de service Web XML ou des informations stockées dans le fichier .ini d'une application. Les paires clé/valeur spécifiées dans l'élément <appSettings> sont accessibles dans du code à l'aide de la classe System.Configuration.ConfigurationSettings.

Vous pouvez utiliser l'attribut file dans l'élément <appSettings> des fichiers Web.config et de configuration de l'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 des scénarios de développement en équipe de contrôle de source comme lorsqu'un utilisateur souhaite remplacer les paramètres du projet spécifiés dans un fichier de configuration de l'application.

Les fichiers de configuration spécifiés par l'attribut file doivent avoir <appSettings> au lieu de <configuration> comme nœud racine. Le code suivant est correct pour un fichier de configuration spécifié avec l'attribut file :

            <?xml version="1.0" encoding="utf-8" ?>
            <appSettings>
            <add key="Application1" value="MyApplication1" />
            <add key="Setting1" value="MySetting" />
            </appSettings>

Exemple

L'exemple suivant montre comment définir un paramètre d'application personnalisé dans un fichier de configuration.

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

Fichier de configuration

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

Voir aussi

Schéma des sections de configuration | Paramètres des sections de configuration

Partager via