Compartir a través de

Elemento remove para configSections (Esquema de configuración general)

  • Artículo

Actualización: noviembre 2007

Quita una referencia a una sección y un grupo de secciones heredados.

Elemento configuration (Esquema de configuración general)
  Elemento configSections (Esquema de configuración general)
    Elemento remove 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 remove para configSections (Esquema de configuración general)

<remove 
   name="section name" 
/>

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

name

Atributo String requerido.

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 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 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 es aplicable.

Miembro de configuración

Remove(String)

Remove(String)

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

Administrar sitios web ASP.NET

API de configuración de ASP.NET