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

项目
05/28/2012

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

为 ASP.NET 应用程序和功能指定数据库连接字符串（名称/值对的形式）的集合。

此元素是 .NET Framework 2.0 版中的新元素。

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

特性和元素

下面几部分描述了此元素的特性、子元素和父元素。

特性

只有那些由所有节元素继承的特性。有关更多信息，请参见节元素所继承的常规特性。在 ASP.NET 应用程序中，可以在运行时为 ConfigSource 特性分配备选配置文件的名称。在这种情况下，Web.config 文件中包含的默认连接字符串信息将覆盖该文件的内容。当替代文件不存在，并在运行时创建它时，也会发生该情况。如果 Web.config 文件不包含任何连接字符串信息，则空 connectionStrings 部分会添加到替代文件。

子元素

元素	说明
Add	向连接字符串集合添加名称/值对形式的连接字符串。
Clear	移除对继承的连接字符串的所有引用，只允许由当前 add 元素添加的连接字符串。
remove	从连接字符串集合中移除对继承的连接字符串的引用。

父元素

元素	说明
configuration	指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
System.web	指定配置文件中 ASP.NET 配置设置的根元素，并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。

备注

connectionStrings 元素为 ASP.NET 应用程序和功能指定数据库连接字符串（名称/值对的形式）的集合。

在以前的 ASP.NET 版本中，连接字符串存储在 appSettings 中。在 ASP.NET 2.0 中，如会话、成员资格、个性化设置和角色管理器等功能均依赖于存储在 connectionStrings 元素中的连接字符串。您还可以使用 connectionStrings 元素来存储您自己的应用程序的连接字符串。

默认配置

除非在子配置文件中使用 clear 元素，否则将继承父配置文件中包含的连接字符串。下面的默认 connectionStrings 元素是在 Machine.config 文件中配置的。

可以编程方式访问 connectionStrings 元素。有关更多信息，请参见 ConnectionStrings 示例。

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

示例

下面的代码示例演示如何配置两个连接字符串。第一个连接字符串可以由 ASP.NET 应用程序使用，而第二个连接字符串可以由稍后配置的 sqlCacheDependency 元素使用。

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

元素信息

配置节处理程序	ConnectionStringsSection
配置成员	ConnectionStringSettingsCollection ConnectionStrings ConnectionStrings ConnectionStrings
可配置的位置	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

请参见

通过

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

特性和元素

特性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源