萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

.NET 類庫直連 MySQL 實戰:ODBC 驅動與封裝模式

在 .NET 應用中直接操作 MySQL,官方推薦使用 MySQL Connector/NET (全託管 ADO.NET 提供者)。但早期專案或特定環境 (如受限伺服器無法安裝托管提供者) 仍可能依賴 ODBC 路徑。本文記錄基於 **MySQL ODBC 3.51 Driver + Microsoft ODBC.NET Provider** 封裝類庫的實戰經驗,供維護舊系統參考;新專案請直接採用 MySql.Data.MySqlClient 或 MySqlConnector。

環境依賴安裝

  1. MySQL ODBC 3.51 Driver:官方下載,安裝於應用程式伺服器。
  2. Microsoft ODBC.NET Data Provider:下載,提供 System.Data.Odbc 命名空間 (現已內建於 .NET Framework 1.1+,額外安裝僅針對 1.0 版)。

類庫架構三大類別

類別職責核心方法
ManipStringForMySQLSQL 字串清洗、參數化、防注入輔助EscapeSingleQuotes、FormatDate、BuildInClause
MySQL_Requettes執行查詢、非查詢、資料集填充MyODBCDataset、ExecuteNonQuery、ExecuteScalar
MySQL_Utils連線測試、資料庫/資料表存在性檢查TestConnection、TableExists、GetSchema

核心實作:MyODBCDataset — 填充 DataSet

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();

關鍵技術細節與避坑指南

  1. 參數化查詢:ODBC 使用 ? 佔位符 (非 @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();
    }
  2. 連線字串 OPTION 旗標:OPTION=3 (回傳自增 ID)、OPTION=131072 (啟用壓縮協定) 等,參考 MySQL ODBC 手冊。
  3. 字元集編碼:連線字串加入 CHARSET=utf8mb4; 確保 Unicode (含 Emoji) 正確存取。
  4. 連線池:ODBC.NET 自動啟用連線池,確保連線字串**完全一致** (大小寫、空白、屬性順序) 以複用連線。
  5. 例外處理:捕獲 OdbcException 解析 Errors 集合取得 MySQL 原生錯誤碼 (如 1062 Duplicate Entry),避免吞噬關鍵診斷資訊。

現代化替代方案強烈推薦

方案NuGet 套件優勢適用場景
MySQL Connector/NETMySql.Data官方、完整 ADO.NET 實作、支援所有 MySQL 功能傳統 .NET Framework 專案
MySqlConnectorMySqlConnector全託管、高效能、非同步完整支援、.NET Standard 2.0+、開源.NET Core / .NET 5+ / 跨平台 / 高併發 (首選)
Dapper + MySqlConnectorDapper + MySqlConnector微輕量 ORM、效能極佳、SQL 可控追求極致效能與開發體驗
Entity Framework CoreMicrosoft.EntityFrameworkCore + Pomelo.EntityFrameworkCore.MySql完整 ORM、LINQ、遷移、変更追蹤領域模型豐富、團隊標準化開發

結語

ODBC 路徑雖通用但層次多 (應用 → ODBC.NET → ODBC Driver → MySQL Server),效能損耗大、除錯難、部署繁瑣。除非受限於極舊環境,**新專案請毫不猶豫選擇 MySqlConnector**,享受原生非同步、高效能、零相依部署的現代體驗。

copyright © 萬盛學電腦網 all rights reserved