clear Element for connectionStrings (ASP.NET Settings Schema) 

  • Article

Removes all references to inherited connection strings, allowing only the connection strings that are added by the current add element.

This element is new in the .NET Framework version 2.0.

<clear />

Attributes and Elements

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

Attributes

None.

Child Elements

None.

Parent Elements

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.

system.web

Specifies the root element for the ASP.NET configuration settings in a configuration file and contains configuration elements that configure ASP.NET Web applications and control how the applications behave.

connectionStrings

Specifies a collection of database connection strings, as name/value pairs, for ASP.NET applications and features.

Remarks

The clear element removes all references to inherited connection strings from the collection that is stored in the connectionStrings element, allowing only the connection strings that are added by the current add element.

The connectionStrings element specifies a collection of database connection strings, as name/value pairs, for ASP.NET applications and features.

Example

The following code example shows how to clear the inherited connection strings.

<configuration>
  <connectionStrings>
    <clear/>
  </connectionStrings>
</configuration>

Element Information

Configuration section handler

ConnectionStringsSection

Configuration member

Clear

Configurable locations

Machine.config

Root-level Web.config

Application-level Web.config

Virtual or physical directory–level Web.config

Requirements

Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0

The .NET Framework version 2.0

Microsoft Visual Studio 2003 or Visual Studio 2005

See Also

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

clear Element for connectionStrings (ASP.NET Settings Schema)
configuration Element (General Settings Schema)
add Element for connectionStrings (ASP.NET Settings Schema)
remove Element for connectionStrings (ASP.NET Settings Schema)

Concepts

ASP.NET Configuration Overview
Securing ASP.NET Configuration
ASP.NET Data Access Overview
Securing Data Access
ASP.NET Configuration Scenarios