Elemento clear para configSections (Esquema de configuración general)
Actualización: noviembre 2007
Quita todas las referencias a secciones y grupos de sección heredados, y sólo permite las secciones y los grupos de sección agregados por los elementos section y sectionGroup actuales.
Elemento configuration (Esquema de configuración general)
Elemento configSections (Esquema de configuración general)
Elemento clear para configSections (Esquema de configuración general)
Elemento configuration (Esquema de configuración general)
Elemento configSections (Esquema de configuración general)
Elemento sectionGroup para configSections (Esquema de configuración general)
Elemento clear para configSections (Esquema de configuración general)
<clear />
Atributos y elementos
Las siguientes secciones describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Ninguno.
Elementos secundarios
Ninguno.
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Especifica el elemento raíz necesario en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .NET Framework. |
configSections |
Especifica las declaraciones de las secciones de configuración y del espacio de nombres. |
sectionGroup |
Define una asociación entre un controlador de sección de configuración y una sección de configuración. |
Comentarios
El elemento clear quita todas las referencias a secciones y grupos de sección heredados, y sólo permite las secciones y los grupos de sección agregados por los elementos section y sectionGroup actuales.
Si un archivo de configuración intenta utilizar una sección de configuración después de haber quitado la referencia al controlador, ASP.NET emite el error del servidor "Sección de configuración element_name no reconocida".
Ejemplo
En el ejemplo de código siguiente se muestra cómo utilizar el elemento clear en un archivo de configuración de aplicación para borrar secciones que se han definido previamente en el archivo Machine.config.
En el código siguiente, de un archivo Machine.config, se declaran dos secciones, sampleSection y anotherSampleSection, que se leen antes que el archivo de configuración de la aplicación.
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler" />
<section name="anotherSampleSection"
type="System.Configuration.NameValueSectionHandler" />
</configSections>
<sampleSection setting1="Value1" setting2="value two"
setting3="third value" />
</configuration>
En el siguiente código, extraído de un archivo de configuración de la aplicación, se borran todas las secciones declaradas anteriormente. La aplicación no puede utilizar ni recuperar los valores contenidos en ninguna de las secciones que se han declarado en el archivo Machine.config. Sin embargo, la aplicación sí puede usar los valores de anotherSection porque anotherSection está después del elemento clear.
<configuration>
<configSections>
<clear/>
<section name="anotherSection"
type="System.Configuration.NameValueSectionHandler" />
</configSections>
</configuration>
Información de elemento
Controlador de la sección de configuración |
No es aplicable. |
Miembro de configuración |
|
Ubicaciones configurables |
Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorio virtual o físico |
Requisitos |
Servicios de Microsoft Internet Information Server (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vea también
Conceptos
Jerarquía de archivos y herencia de la configuración de ASP.NET
Editar los archivos de configuración de ASP.NET
Escenarios de configuración de ASP.NET
Referencia
Elemento configSections (Esquema de configuración general)
Elemento sectionGroup para configSections (Esquema de configuración general)
Elemento section para configSections (Esquema de configuración general)
Elemento remove para configSections (Esquema de configuración general)
Elemento configuration (Esquema de configuración general)
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Archivos de configuración de ASP.NET