ASP.NET Syntax   ASP.NET Configuration Sections

---

Removes a reference to an inherited section and section group.

<remove name = "section name" />

The following sections describe attributes, child elements, and parent elements.

Attribute	Description
name	Required String attribute. Specifies the name of the section or section group to remove. This attribute is the same as the name attribute in the section or sectionGroup element that added the reference.

None.

Element	Description
configuration	Specifies the required root element in every configuration file that is used by the common language runtime and the .NET Framework applications.
configSections	Specifies configuration section and namespace declarations.
sectionGroup	Defines an association between a configuration section handler and a configuration section.

The remove element removes a reference to an inherited sections or section groups. New sections and section groups can be added to the collection in the current configuration file by using the section and sectionGroup elements.

If a configuration file tries to use a configuration section after the handler reference is removed, ASP.NET issues the server error, "Unrecognized configuration section element_name".

The following code example shows how to use the remove element in an application configuration file to remove a section that was previously defined in the Machine.config file.

The following Machine.config file code declares a section named sampleSection.

<configuration>

   <configSections>
      <section name = "sampleSection"
         type = "System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1 = "Value1" 
      setting2 = "value two" 
      setting3 = "third value" />

</configuration>

The following example application configuration file removes the sampleSection section. After removal, the application cannot retrieve the settings that are in sampleSection. If a configuration file tries to use a configuration section after the handler reference is removed, ASP.NET issues the server error, "Unrecognized configuration section element_name".

<configuration>

   <configSections>
      <remove name = "sampleSection" />
   </configSections>

</configuration>

<configSections> Section   <configSections> clear Element   <configSections> section Element   <configSections> sectionGroup Element

Books and more ...

Custom Search

Suggested Reading

Need a break ?