.NET 操作 MySQL 的官方驅動提供豐富的 ADO.NET 實現類別。掌握核心類別職責,能寫出高效、健壯的資料存取層。
// C# 程式碼頂部
using MySql.Data.MySqlClient;
// ASP.NET Web Forms 頁面指令
<%@ Import Namespace="MySql.Data.MySqlClient" %>
| 類別 | 核心職責 | 典型使用場景 |
|---|---|---|
| MySqlConnection | 管理與 MySQL 伺服器的物理連線、連線池、交易啟動 | `using (var conn = new MySqlConnection(cs)) { conn.Open(); ... }` |
| MySqlCommand | 封裝 SQL 指令/預存程序、參數集合、執行方式 (ExecuteReader/NonQuery/Scalar) | `var cmd = new MySqlCommand(sql, conn); cmd.Parameters.AddWithValue("@p", val);` |
| MySqlDataReader | 唯讀、順向、流式讀取結果集,佔用記憶體極低 | `using (var rdr = cmd.ExecuteReader()) while(rdr.Read()) { ... }` |
| MySqlDataAdapter | 橋接 DataSet/DataTable 與資料庫,支援離線操作、批次更新 | `var da = new MySqlDataAdapter(cmd); da.Fill(dt);` |
| MySqlException | 封裝 MySQL 錯誤碼 (Number)、SQLState、訊息,便於分類捕獲 | `catch (MySqlException ex) when (ex.Number == 1062) { /* 重複鍵 */ }` |
const string connStr = "Server=localhost;Database=test;Uid=app;Pwd=secret;Pooling=true;MinPoolSize=5;MaxPoolSize=100;";
public IEnumerable GetActiveUsers() {
const string sql = "SELECT id, username, email FROM users WHERE status=1 AND created_at > @since";
var users = new List();
using (var conn = new MySqlConnection(connStr))
using (var cmd = new MySqlCommand(sql, conn)) {
cmd.Parameters.AddWithValue("@since", DateTime.UtcNow.AddDays(-30));
conn.Open();
using (var rdr = cmd.ExecuteReader()) {
while (rdr.Read()) {
users.Add(new User {
Id = rdr.GetInt32("id"),
Username = rdr.GetString("username"),
Email = rdr.GetString("email")
});
}
}
}
return users;
}