connectionStrings 項目 (ASP.NET 設定結構描述)

發行項
08/12/2011

針對 ASP.NET 應用程式和功能，指定資料庫連接字串集合 (做為名稱/值的配對)。

這個項目是 .NET Framework 2.0 版中新增的項目。

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

屬性和項目

下列小節描述這個項目的屬性、子項目和父項目。

屬性

無，除了由所有區段項目所繼承的屬性以外。如需詳細資訊，請參閱Section 項目繼承的一般屬性。在 ASP.NET 應用程式中，您可以在執行階段將替代組態檔的名稱指派給 ConfigSource 屬性。在這種情況下，包含在 Web.config 檔中的預設連接字串資訊就會覆寫檔案的內容。當替代檔案不存在，且它是在執行階段建立的，也會發生這個問題。如果 Web.config 不包含任何連接字串資訊，會將空的 connectionStrings 區段加入至替代檔案。

子項目

項目	描述
Add	將連接字串 (Connection String) 當做名稱/值組，加入至連接字串集合。
Clear	移除繼承之連接字串的所有參考，只允許由目前的 add 項目所加入的連接字串。
remove	移除連接字串集合中繼承連接字串的參考。

父項目

項目	描述
configuration	指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。
System.web	指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 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 Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

connectionStrings 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設的組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源