remove Element for connectionStrings (ASP.NET Settings Schema)

Removes a reference to an inherited connection string from the collection of connections strings.

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

<remove 
   name="connection string name" 
/>

Attributes and Elements

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

Attributes

Attribute Description

name

Required String attribute.

Specifies the collection key that is used to identify the connection string. If the key does not exist, no error is issued.

This attribute is the same as the name attribute that is used in the add element that was used to add the connection string to the collection.

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 remove element removes a reference to an inherited connection string from the collection of connections strings that is stored in the connectionStrings 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 remove an inherited connection string.

<configuration>
  <connectionStrings>   
    <remove 
      name="Northwind"/>   
  </connectionStrings>
</configuration>

Element Information

Configuration section handler

ConnectionStringsSection

Configuration member

Remove

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)
clear Element for connectionStrings (ASP.NET Settings Schema)
add Element for connectionStrings (ASP.NET Settings Schema)
ConnectionStringsSection
Remove

Concepts

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