configuration, élément (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.]

É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 de communication à distance	Spécifie tous les éléments figurant dans le schéma des paramètres de communication à distance.
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

Accessing ASP.NET Configuration Settings

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)

Concepts

ASP.NET Configuration Overview

Securing Configuration

Fichiers de configuration

Format of ASP.NET Configuration Files

Configuration Inheritance

Autres ressources

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

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API