Attributs généraux hérités par les éléments Section

ASP.NET applique les paramètres de configuration aux ressources de manière hiérarchique. Les paramètres de configuration sont hérités de fichiers de configuration parents. Cette rubrique répertorie plusieurs attributs généraux hérités par tous les éléments Section.

Éléments Section

Les éléments de section appartiennent aux sections de configuration. Ils n'incluent pas les éléments qui appartiennent à des groupes de sections de configuration.

Les déclarations de sections de configuration apparaissent au haut du fichier de configuration à l'intérieur de l'élément configSections. Chaque déclaration contenue dans un élément section spécifie le nom d'une section et le nom de la classe .NET Framework (dérivé de ConfigurationSection) qui traite les données de configuration de cette section. Les balises section peuvent être regroupées dans des balises sectionGroup.

Pour plus d'informations, consultez Fichiers de configuration ASP.NET ou Modification des fichiers de configuration ASP.NET.

Attributs généraux

Le tableau suivant décrit les attributs généraux qui peuvent être définis pour tout élément de section. Ces attributs généraux sont également hérités par les éléments enfants des éléments Section. Tous les attributs dont les noms incluent le mot lock sont conçus pour protéger le contenu spécifié dans le fichier de configuration contre toute modification. Aucun élément ou attribut n'est verrouillé par défaut.

Attribut	Description
configSource	Attribut String facultatif. Spécifie le nom du fichier d'inclusion dans lequel la section de configuration associée est définie, si un tel fichier existe. Accessible par programme par le biais de la propriété ConfigSource. Lorsque vous utilisez l'attribut configSource, vous devez déplacer la section entière dans un fichier distinct car les paramètres des éléments ne sont pas fusionnés. Toute modification apportée au fichier externe provoque par défaut le redémarrage de l'application. Pour modifier ce comportement et empêcher que l'application redémarre après chaque modification, vous pouvez configurer la section, élément de configSections (Schéma des paramètres généraux) dans le fichier Web.config et affecter à son attribut restartOnExternalChanges la valeur false.
lockAllAttributesExcept	Attribut String facultatif ; la valeur peut être une liste délimitée par des virgules. Verrouille tous les attributs de l'élément parent sauf ceux qui sont spécifiés. Accessible par programme par le biais de la propriété LockAllAttributesExcept. Les niveaux inférieurs de la hiérarchie de configuration ne peuvent jamais verrouiller des niveaux situés au-dessus d'eux dans la hiérarchie.
lockAllElementsExcept	Attribut String facultatif ; la valeur peut être une liste délimitée par des virgules. Verrouille tous les éléments enfants de l'élément parent sauf ceux qui sont spécifiés. Accessible par programme par le biais de la propriété LockAllElementsExcept.
lockAttributes	Attribut String facultatif ; la valeur peut être une liste délimitée par des virgules. Verrouille tous les attributs de l'élément parent. Accessible par programme par le biais de la propriété LockAttributes.
lockElements	Attribut String facultatif ; la valeur peut être une liste délimitée par des virgules. Verrouille tous les éléments enfants de l'élément parent. Accessible par programme par le biais de la propriété LockElements.
lockItem	Attribut String facultatif. true si l'élément sur lequel porte l'attribut doit être verrouillé ; sinon, false. La valeur par défaut est false. Outre qu'il permet de verrouiller un élément individuel, cet attribut peut également être utilisé sur des éléments de collection pour les verrouiller spécifiquement dans une collection spécifiée. Par ailleurs, l'attribut peut être utilisé pour verrouiller une section entière quelconque. Accessible par programme par le biais de la propriété LockItem.

Exemple

L'exemple de code suivant est une partie du fichier Machine.config. Les gestionnaires de section de configuration sont déclarés pour le groupe de sections system.web et la section anonymousIdentification. Au-dessous, les éléments de configuration system.Web et anonymousIdentification sont déclarés.

L'élément de configuration system.Web appartient à un groupe de sections de configuration, ce qui signifie qu'il ne contient aucun attribut.

L'élément de configuration anonymousIdentification est membre d'une section de configuration ; par conséquent, il hérite des attributs répertoriés dans le tableau précédent. Notez que son attribut configSource possède un fichier externe qui lui est assigné (pour contenir le contenu de l'élément), et que l'attribut lockItem a la valeur true pour empêcher la modification de son contenu.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

Voir aussi

Tâches

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Scénarios de configuration ASP.NET

Sécurisation de la configuration ASP.NET

Modification des fichiers de configuration ASP.NET

Autres ressources

Fichiers de configuration ASP.NET