ASP.NET Web.config 外部配置檔分離技巧：configSource 屬性完整指南

為何需要外部配置檔？

連接字串、應用程式設定等敏感資訊不宜直接提交至版控系統，且不同環境 (Dev/Test/Prod) 設定不同。configSource 屬性可將特定區段外部化，實現「配置與代碼分離、環境隔離、權限管控」。

基本語法與規則

<configuration>
  <connectionStrings configSource="configs\db.config" />
  <appSettings configSource="configs\appsettings.config" />
</configuration>

三大鐵律（違反即報錯）

1. 外部檔案根節點必須與區段名稱完全一致：<connectionStrings> 對應 <connectionStrings> 根節點。
2. 指定 configSource 後，Web.config 內同區段節點完全失效（即使保留也不會被讀取）。
3. 一個區段只能指向一個外部檔案，不可多區段共用同一外部檔案。

實戰範例：連接字串外部化

Web.config

<connectionStrings configSource="Config\ConnectionStrings.config" />

Config\ConnectionStrings.config

<connectionStrings>
  <add name="DefaultConnection" 
       connectionString="Data Source=.;Initial Catalog=MyDb;Integrated Security=True" 
       providerName="System.Data.SqlClient" />
  <add name="ReportConnection" 
       connectionString="Data Source=ReportSrv;Initial Catalog=ReportDb;User Id=rep;Password=pwd" 
       providerName="System.Data.SqlClient" />
</connectionStrings>

程式碼讀取方式不變

// 連接字串
string connStr = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;

// AppSettings
string uploadPath = ConfigurationManager.AppSettings["UploadPath"];

進階應用：環境專屬配置自動切換

目錄結構

/Config
    /ConnectionStrings.config        ← 預設 (開發環境)
    /ConnectionStrings.Prod.config   ← 生產環境
    /ConnectionStrings.Test.config   ← 測試環境

部署腳本 (PowerShell/MSBuild/DevOps Pipeline) 依環境複製對應檔案

# 部署至生產環境時
Copy-Item "Config\ConnectionStrings.Prod.config" "Config\ConnectionStrings.config" -Force

注意事項與限制

總結

configSource 是傳統 ASP.NET 實現配置外部化最原生、零依賴的方案。嚴守三大鐵律，結合部署流程自動切換環境配置，即可安全、優雅地管理敏感設定。遷移至 ASP.NET Core 時，請改用新配置系統。