C# 連接 SQL Server 數據庫完整教程：從連接字符串到增刪改查

1. 安裝驅動

NuGet 安裝 Microsoft.Data.SqlClient（推薦）或 System.Data.SqlClient。

2. 連接字符串

// appsettings.json
"ConnectionStrings": {
  "Default": "Server=localhost;Database=MyDb;User Id=sa;Password=123456;TrustServerCertificate=True;"
}

3. 核心代碼模板

using Microsoft.Data.SqlClient;
using System.Data;

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

using (var conn = new SqlConnection(connStr))
{
    conn.Open();
    // 查詢單值
    using (var cmd = new SqlCommand("SELECT COUNT(*) FROM Users", conn))
    {
        int count = (int)cmd.ExecuteScalar();
    }
    // 參數化查詢
    using (var cmd = new SqlCommand("SELECT * FROM Users WHERE Age > @age", conn))
    {
        cmd.Parameters.AddWithValue("@age", 18);
        using (var reader = cmd.ExecuteReader())
        {
            while (reader.Read()) { Console.WriteLine(reader["Name"]); }
        }
    }
    // 異步執行
    await using (var cmd = new SqlCommand("INSERT INTO Users(Name,Age) VALUES(@n,@a)", conn))
    {
        cmd.Parameters.AddWithValue("@n", "Tom");
        cmd.Parameters.AddWithValue("@a", 30);
        int rows = await cmd.ExecuteNonQueryAsync();
    }
}

4. 最佳實踐

• 始終使用 using 確保連接釋放。
• 嚴禁字符串拼接 SQL，防止注入。
• 連接池默認開啟，無需手動管理。
• 異步方法 (Async 後綴) 提升高併發吞吐。