在 .NET 應用中直接操作 MySQL,官方推薦使用 MySQL Connector/NET (全託管 ADO.NET 提供者)。但早期專案或特定環境 (如受限伺服器無法安裝托管提供者) 仍可能依賴 ODBC 路徑。本文記錄基於 **MySQL ODBC 3.51 Driver + Microsoft ODBC.NET Provider** 封裝類庫的實戰經驗,供維護舊系統參考;新專案請直接採用 MySql.Data.MySqlClient 或 MySqlConnector。
System.Data.Odbc 命名空間 (現已內建於 .NET Framework 1.1+,額外安裝僅針對 1.0 版)。| 類別 | 職責 | 核心方法 |
|---|---|---|
| ManipStringForMySQL | SQL 字串清洗、參數化、防注入輔助 | EscapeSingleQuotes、FormatDate、BuildInClause |
| MySQL_Requettes | 執行查詢、非查詢、資料集填充 | MyODBCDataset、ExecuteNonQuery、ExecuteScalar |
| MySQL_Utils | 連線測試、資料庫/資料表存在性檢查 | TestConnection、TableExists、GetSchema |
public static DataSet MyODBCDataset(
string reqSQL, string laBase, string server,
string password, string user, string nomDataSet)
{
// 1. 建立 ODBC 連線字串 (DRIVER 必須與安裝驅動名稱完全一致)
string myConString =
"DRIVER={MySQL ODBC 3.51 Driver};" +
$"SERVER={server};" +
$"DATABASE={laBase};" +
$"UID={user};" +
$"PASSWORD={password};" +
"OPTION=3;"; // OPTION=3 表示傳回插入資料的自動遞增 ID
using (var conn = new OdbcConnection(myConString))
{
try
{
var ds = new DataSet();
using (var adapter = new OdbcDataAdapter(reqSQL, myConString))
{
adapter.Fill(ds, nomDataSet);
}
return ds;
}
catch (OdbcException odbcEx)
{
// 記錄詳細錯誤碼 (odbcEx.Errors 集合)
throw new ApplicationException($"MySQL ODBC 錯誤: {odbcEx.Message}", odbcEx);
}
catch (Exception ex)
{
throw new ApplicationException($"資料存取層異常: {ex.Message}", ex);
}
}
}
// 常數集中管理
public static class Constantes
{
public const string ODBCBase = "myDatabase";
public const string ODBCServer = "127.0.0.1";
public const string ODBCUser = "app_user";
public const string ODBCPwd = "secure_password";
}
// 使用
string sql = "SELECT * FROM products WHERE category_id = ?categoryId AND active = 1";
var ds = MySQL_Requettes.MyODBCDataset(
sql,
Constantes.ODBCBase, Constantes.ODBCServer,
Constantes.ODBCPwd, Constantes.ODBCUser,
"ProductList");
// 繫結至 GridView
gridProducts.DataSource = ds.Tables["ProductList"];
gridProducts.DataBind();
? 佔位符 (非 @param),參數順序必須與 SQL 中出現順序一致。
using (var cmd = new OdbcCommand("INSERT INTO logs(msg, created) VALUES(?, ?)", conn))
{
cmd.Parameters.AddWithValue("@msg", message); // 參數名僅供可讀性,實際按順序繫結
cmd.Parameters.AddWithValue("@created", DateTime.Now);
cmd.ExecuteNonQuery();
}
OPTION=3 (回傳自增 ID)、OPTION=131072 (啟用壓縮協定) 等,參考 MySQL ODBC 手冊。CHARSET=utf8mb4; 確保 Unicode (含 Emoji) 正確存取。OdbcException 解析 Errors 集合取得 MySQL 原生錯誤碼 (如 1062 Duplicate Entry),避免吞噬關鍵診斷資訊。| 方案 | NuGet 套件 | 優勢 | 適用場景 |
|---|---|---|---|
| MySQL Connector/NET | MySql.Data | 官方、完整 ADO.NET 實作、支援所有 MySQL 功能 | 傳統 .NET Framework 專案 |
| MySqlConnector | MySqlConnector | 全託管、高效能、非同步完整支援、.NET Standard 2.0+、開源 | .NET Core / .NET 5+ / 跨平台 / 高併發 (首選) |
| Dapper + MySqlConnector | Dapper + MySqlConnector | 微輕量 ORM、效能極佳、SQL 可控 | 追求極致效能與開發體驗 |
| Entity Framework Core | Microsoft.EntityFrameworkCore + Pomelo.EntityFrameworkCore.MySql | 完整 ORM、LINQ、遷移、変更追蹤 | 領域模型豐富、團隊標準化開發 |
ODBC 路徑雖通用但層次多 (應用 → ODBC.NET → ODBC Driver → MySQL Server),效能損耗大、除錯難、部署繁瑣。除非受限於極舊環境,**新專案請毫不猶豫選擇 MySqlConnector**,享受原生非同步、高效能、零相依部署的現代體驗。