Atributos generales heredados por elementos de una sección

ASP.NET aplica las opciones de configuración a los recursos de manera jerárquica. Las opciones de configuración se heredan de los archivos de la configuración principal. En este tema se muestran varios atributos generales que son heredados por todos los elementos de sección.

Elementos de sección

Los elementos de sección son los miembros de las secciones de configuración. Esto no incluye los elementos que son miembros de grupos de secciones de configuración.

Las declaraciones de sección de configuración aparecen en la parte superior del archivo de configuración, dentro del elemento configSections. Cada declaración contenida en un elemento section especifica el nombre de una sección y el nombre de la clase de .NET Framework (derivada de ConfigurationSection) que procesa los datos de configuración en esa sección. Las etiquetas section pueden agruparse en etiquetas sectionGroup.

Para obtener más información, vea Archivos de configuración de ASP.NET o Editar los archivos de configuración de ASP.NET.

Atributos generales

La tabla siguiente describe los atributos generales que se pueden establecer para cualquier elemento de sección. Los elementos secundarios de los elementos de sección también heredan estos atributos generales. Todos los atributos cuyos nombres incluyen la palabra lock están diseñados para impedir que se cambie el contenido especificado en el archivo de configuración. Ningún elemento o atributo está bloqueado de forma predeterminada.

Atributo	Descripción
configSource	Atributo String opcional. Especifica el nombre del archivo de inclusión en el que se define la sección de configuración asociada, si éste existe. Se puede obtener acceso al mismo mediante programación a través de la propiedad ConfigSource. Cuando se utiliza el atributo configSource, es necesario mover la sección completa a un archivo independiente, porque los valores de los elementos no se combinan. Cualquier cambio en el archivo externo hace que la aplicación se reinicie de forma predeterminada. Para cambiar este comportamiento y que la aplicación no se reinicie después de cada cambio, se puede configurar el Elemento section para configSections (Esquema de configuración general) del archivo Web.config y establecer su atributo restartOnExternalChanges en false.
lockAllAttributesExcept	Atributo String opcional cuyo valor puede ser una lista delimitada por comas. Bloquea todos los atributos del elemento primario, excepto los especificados. Se puede obtener acceso al mismo mediante programación a través de la propiedad LockAllAttributesExcept. Los niveles inferiores de la jerarquía de configuración nunca pueden bloquear niveles superiores en la jerarquía.
lockAllElementsExcept	Atributo String opcional cuyo valor puede ser una lista delimitada por comas. Bloquea todos los elementos secundarios del elemento primario, excepto los especificados. Se puede obtener acceso al mismo mediante programación a través de la propiedad LockAllElementsExcept.
lockAttributes	Atributo String opcional cuyo valor puede ser una lista delimitada por comas. Bloquea todos los atributos del elemento primario. Se puede obtener acceso al mismo mediante programación a través de la propiedad LockAttributes.
lockElements	Atributo String opcional cuyo valor puede ser una lista delimitada por comas. Bloquea todos los elementos secundarios del elemento primario. Se puede obtener acceso al mismo mediante programación a través de la propiedad LockElements.
lockItem	Atributo String opcional. Es true si debe bloquearse el elemento en que aparece el atributo; de lo contrario, es false. El valor predeterminado es false. Este atributo, además de utilizarse para bloquear un elemento individual, puede emplearse en los elementos de la colección para bloquearlos específicamente dentro de una colección concreta. Asimismo, el atributo se puede utilizar para bloquear una sección completa. Se puede obtener acceso al mismo mediante programación a través de la propiedad LockItem.

Ejemplo

El ejemplo de código siguiente es un fragmento del archivo Machine.config. Los controladores de sección de configuración se declaran para el grupo de sección system.web y la sección anonymousIdentification. Más abajo, se declaran los elementos de configuración system.Web y anonymousIdentification.

El elemento de configuración system.Web es un miembro de un grupo de sección de configuración y, por lo tanto, no contiene ningún atributo.

El elemento de configuración anonymousIdentification es un miembro de una sección de configuración y, por tanto, hereda los atributos enumerados en la tabla anterior. Observe que su atributo configSource tiene asignado un archivo externo (para incluir el contenido del elemento) y que el atributo lockItem se ha establecido en true para impedir que se realicen cambios en su contenido.

<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>

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Proteger la configuración de ASP.NET

Editar los archivos de configuración de ASP.NET

Otros recursos

Archivos de configuración de ASP.NET