connectionStrings 的 add 元素（ASP.NET 设置架构）

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

向连接字符串集合添加名称/值对形式的连接字符串。

此元素是 .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>

元素信息

配置节处理程序	ConnectionStringsSection
配置成员	Add(ConnectionStringSettings)
可配置的位置	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

请参见

Share via

connectionStrings 的 add 元素（ASP.NET 设置架构）

特性和元素

特性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源