add, élément de appSettings (Schéma des paramètres généraux)
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
Ajoute un paramètre d'application personnalisé en tant que paire nom/valeur à la collection de paramètres d'application.
<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. |
É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.
Important
Les touches doivent être uniques.Si vous ajoutez plusieurs entrées avec la même clé, seule la dernière entrée est conservée.
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. L'exemple de classe indique comment accéder à appSettings par programmation.
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 |
|
Membre de configuration |
|
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
Référence
appSettings, élément (Schéma des paramètres généraux)
configuration, élément (Schéma des paramètres généraux)
clear, élément de appSettings (Schéma des paramètres généraux)
remove, élément de appSettings (Schéma des paramètres généraux)
Concepts
Autres ressources
Paramètres généraux de configuration (ASP.NET)