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

Mise à jour : novembre 2007

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

<configuration xmlns="schema URL">
   <!-- configuration settings -->
</configuration>

Attributs et éléments

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

Attributs

Attribut	Description
xmlns	Attribut String facultatif. Spécifie l'URL vers le schéma XML permettant de valider le fichier de configuration. Si cet attribut n'est pas défini, vous ne pouvez pas utiliser la touche F1 (Aide) dans Microsoft Visual Studio pour ouvrir des rubriques relatives aux éléments de configuration. La valeur par défaut d'ASP.NET version 2.0 est "https://schemas.microsoft.com/.NetConfiguration/v2.0".

Éléments enfants

Élément	Description
configSections	Spécifie une section de configuration et des déclarations d'espace de noms.
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.
connectionStrings	Spécifie une collection de chaînes de connexion à une base de données, sous la forme de paires nom/valeur, pour les applications et les fonctionnalités ASP.NET.
location	Spécifie la ressource à laquelle s'appliquent les paramètres de configuration enfants. Cet élément verrouille également les paramètres de configuration pour empêcher la substitution des paramètres par les fichiers de configuration enfants.
Schéma des paramètres ASP.NET	Spécifie tous les éléments figurant dans le schéma de configuration ASP.NET.
Schéma des paramètres de démarrage	Spécifie tous les éléments figurant dans le schéma des paramètres de démarrage.
Schéma des paramètres d'exécution	Spécifie tous les éléments figurant dans le schéma des paramètres d'exécution.
Schéma des paramètres d'accès distant	Spécifie tous les éléments figurant dans le schéma des paramètres d'accès distant.
Schéma des paramètres réseau	Spécifie tous les éléments figurant dans le schéma des paramètres réseau.
Schéma des paramètres de chiffrement	Spécifie tous les éléments figurant dans le schéma des paramètres de chiffrement.
Schéma des sections de configuration	Spécifie tous les éléments figurant dans le schéma des paramètres des sections de configuration.
Schéma des paramètres de traçage et de débogage	Spécifie tous les éléments figurant dans le schéma des paramètres de traçage et de débogage.
Schéma des paramètres des services Web XML	Spécifie tous les éléments figurant dans le schéma des paramètres des services Web.

Éléments parents

Aucun.

Notes

L'élément configuration est l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

Chaque fichier de configuration doit contenir exactement un élément configuration.

Configuration par défaut

L'exemple de code suivant illustre un fichier Web.config simple qu'il est possible de créer pour n'importe quelle application ASP.NET. La section customErrors est fournie en cas de besoin, mais mise en commentaire.

<?xml version="1.0"?>
<configuration 
   xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <compilation debug="false"/>
        <authentication mode="Windows"/>
        <!--
        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration	Non applicable.
Membre de configuration	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

Tâches

Comment : accéder par programme aux paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Sécurisation de la configuration ASP.NET

Modification des fichiers de configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

configSections, élément (Schéma des paramètres généraux)

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

connectionStrings, élément (Schéma des paramètres ASP.NET)

location, élément (Schéma des paramètres ASP.NET)

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET

Fichiers de configuration