add, élément de appSettings (Schéma des paramètres généraux)

Article
09/04/2008

Mise à jour : novembre 2007

Ajoute un paramètre d'application personnalisé en tant que paire nom/valeur à la collection de paramètres d'application.

configuration, élément (Schéma des paramètres généraux)
appSettings, élément (Schéma des paramètres généraux)
add, élément de appSettings (Schéma des paramètres généraux)

<add
   key="String name"
   value="String value"
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
key	Attribut String requis. Spécifie le nom du paramètre d'application. Cet attribut est la clé de collection.
value	Attribut String requis. Spécifie la valeur du paramètre d'application.
Attributs hérités	Attributs facultatifs. Attributs hérités par tous les éléments de section. Pour plus d'informations, consultez Attributs généraux hérités par les éléments Section.

key

Attribut String requis.

Spécifie le nom du paramètre d'application. Cet attribut est la clé de collection.

value

Attribut String requis.

Spécifie la valeur du paramètre d'application.

Attributs hérités

Attributs facultatifs.

Attributs hérités par tous les éléments de section. Pour plus d'informations, consultez Attributs généraux hérités par les éléments Section.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.
appSettings	Contient des paramètres d'application personnalisés, tels que des chemins d'accès, des URL de service Web XML ou des informations stockées dans le fichier .ini d'une application.

Notes

L'élément add ajoute un paramètre d'application personnalisé sous la forme d'une paire nom/valeur à la collection de paramètres d'application hérités dans l'élément appSettings.

L'élément appSettings contient des informations de configuration d'application personnalisées, telles que des chemins d'accès, 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 le code à l'aide de la classe ConfigurationSettings.

Configuration par défaut

L'élément appSettings par défaut est configuré dans le fichier Machine.config des versions 1.0 et 1.1 du .NET Framework.

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </appSettings>

Exemple

Les fichiers de configuration spécifiés dans un attribut file doivent avoir appSettings plutôt que configuration comme nœud racine. Le code suivant est correct pour un fichier de configuration spécifié dans l'attribut file.

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

L'exemple de code 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>

Informations sur les éléments

Gestionnaire de section de configuration	AppSettingsSection
Membre de configuration	Add
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique
Configuration requise	Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Partager via