ASP.NET Web.config 資料庫連接字串完整設定指南 (SQL Server)

Web.config 是 ASP.NET 應用程式的核心設定檔，<connectionStrings> 區段專門管理資料庫連接資訊。本文詳細說明 SQL Server 連接字串的屬性對照、Windows/ SQL 驗證兩種模式寫法、程式碼讀取方式，以及常見錯誤排查。

Web.config 結構與連接字串區段

連接字串必須置於 <configuration> 根節點下的 <connectionStrings> 區段：

SQL Server 連接字串屬性完整對照表

兩種驗證模式完整範例

1. SQL Server 驗證 (帳號/密碼)

2. Windows 整合驗證 (信任連線)

3. 進階：Azure SQL Database / 加密連線

程式碼中讀取連接字串

方式一：ConfigurationManager (標準做法)

using System.Configuration;
using System.Data.SqlClient;

string connStr = ConfigurationManager.ConnectionStrings["SqlConn"].ConnectionString;

using (var conn = new SqlConnection(connStr))
using (var cmd = new SqlCommand("SELECT * FROM Products", conn))
{
    conn.Open();
    using (var reader = cmd.ExecuteReader())
    {
        while (reader.Read()) { /* 處理資料 */ }
    }
}

方式二：Entity Framework Code First (DbContext)

public class MyDbContext : DbContext
{
    public MyDbContext() : base("name=SqlConn") { } // 對應 Web.config name
    public DbSet Products { get; set; }
}

方式三：ASP.NET Core (appsettings.json 但概念相同)

// Startup.cs
services.AddDbContext(options =>
    options.UseSqlServer(Configuration.GetConnectionString("SqlConn")));

完整實作範例：GridView 繫結資料

// Default.aspx.cs (若不使用 SqlDataSource 控制項)
protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack) BindGrid();
}

void BindGrid()
{
    string connStr = ConfigurationManager.ConnectionStrings["SqlConn"].ConnectionString;
    using (var da = new SqlDataAdapter("SELECT * FROM publishers", connStr))
    {
        var dt = new DataTable();
        da.Fill(dt);
        GridView1.DataSource = dt;
        GridView1.DataBind();
    }
}

常見問題與最佳實務

連接字串加密部署 (生產環境必做)

# 開發人員命令提示字元 (管理員身分執行)
cd /d C:\YourWebAppPath
aspnet_regiis -pef "connectionStrings" .
# 解密還原
aspnet_regiis -pdf "connectionStrings" .

加密後 Web.config 會顯示 <EncryptedData> 區塊，ASP.NET 執行階段自動解密，無需修改程式碼。

正確管理連接字串是 ASP.NET 應用程式安全與可維護性的基石，建立標準化範本並納入部署流程，能避免大量環境遷移與安全性問題。