Elemento remove para configSections (Esquema de configuración general)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
Quita una referencia a una sección y un grupo de secciones heredados.
<remove
name="section name"
/>
Atributos y elementos
En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Atributo |
Descripción |
|---|---|
name |
El atributo String es obligatorio. Especifica el nombre de la sección o grupo de secciones que se va a quitar. Es igual que el atributo name en el elemento section o elemento sectionGroup que agregó la referencia. |
Elementos secundarios
Ninguno.
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .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 remove quita una referencia a secciones heredadas o grupos de secciones. Las nuevas secciones y grupos de secciones se pueden agregar a la colección en el archivo de configuración actual utilizando los elementos section y sectionGroup.
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 nombre_elemento no reconocida".
Ejemplo
En el ejemplo de código siguiente se muestra cómo utilizar el elemento remove en un archivo de configuración de aplicación para quitar una sección que se ha definido previamente en el archivo Machine.config.
El código del archivo Machine.config siguiente declara una sección denominada sampleSection.
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler" />
</configSections>
<sampleSection setting1="Value1" setting2="value two"
setting3="third value" />
</configuration>
El archivo de configuración de aplicación de ejemplo siguiente quita la sección sampleSection. Una vez quitada, la aplicación no puede recuperar la configuración de sampleSection. 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 nombre_elemento no reconocida".
<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 se aplica. |
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 |
Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vea también
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 clear para configSections (Esquema de configuración general)
Elemento configuration (Esquema de configuración general)
Conceptos
ASP.NET Configuration File Hierarchy
Format of ASP.NET Configuration Files
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET