connectionStrings 的 add 元素（ASP.NET 设置架构）
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
向连接字符串集合添加名称/值对形式的连接字符串。
此元素是 .NET Framework 2.0 版中的新元素。
<add
name="connection string name"
connectionString="connection string"
providerName="ADO.NET data provider"
/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
|---|---|
connectionString |
必选的 String 特性。 定义连接字符串值。 该值可以为空字符串 ("")。 无需进行检查来验证其有效性。 默认值为空字符串 ("")。 |
name |
必选的 String 特性。 定义用于访问连接字符串值的键。 此特性重写同名的任何继承键。 默认值为空字符串 ("")。 |
providerName |
可选的 String 特性。 用于访问基础数据存储区的 ADO.NET 提供程序的名称。 默认值为 "System.Data.SqlClient"。 |
继承的特性 |
可选特性。 由所有节元素继承的特性。 有关更多信息，请参见 节元素所继承的常规特性。 |
子元素
无。
父元素
元素 |
说明 |
|---|---|
configuration |
指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素，并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。 |
connectionStrings |
为 ASP.NET 应用程序和 ASP.NET 功能指定数据库连接字符串（名称/值对的形式）的集合。 |
备注
add 元素将名称/值对形式的连接字符串添加到 connectionStrings 元素的连接字符串集合中。
connectionStrings 元素为 ASP.NET 应用程序和 ASP.NET 功能指定数据库连接字符串（名称/值对的形式）的集合。
默认配置
除非在子配置文件中使用 clear 元素，否则将继承父配置文件中包含的连接字符串。 下面的默认 element 元素是在 Machine.config 文件中配置的。
<connectionStrings>
<add
name="LocalSqlServer"
connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true"
providerName="System.Data.SqlClient"
/>
</connectionStrings>
示例
下面的代码示例演示如何为使用 Northwind 数据库的应用程序配置一个连接字符串。
<configuration>
<connectionStrings>
<add name="Northwind"
connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
providerName="System.Data.SqlClient" />
</connectionStrings>
</configuration>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
要求 |
Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
How to: Lock ASP.NET Configuration Settings
参考
connectionStrings 的 clear 元素（ASP.NET 设置架构）
connectionStrings 的 clear 元素（ASP.NET 设置架构）
connectionStrings 的 remove 元素（ASP.NET 设置架构）