Partager via


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