萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> 資料庫綜合

.NET 操作 MySQL 核心:MySql.Data 命名空間完整類別圖譜與實戰模式

MySqlConnector / MySql.Data 核心類別職責與協作關係

.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;
}

進階特性

  • 連線池:預設啟用,同連線字串復用物理連線,`Pooling=false` 可關閉
  • 非同步支援:`ExecuteReaderAsync`、`OpenAsync` 等,配合 `async/await` 提升吞吐
  • 預存程序:`cmd.CommandType = CommandType.StoredProcedure;`
  • 批次執行:`MySqlBatch` (Connector/NET 8.0+) 或多條 SQL 用 `;` 分隔 (需 `AllowBatch=true`)

避坑指南

  1. **務必 `using` 區塊** 確保連線/讀取器釋放回池
  2. **嚴禁字串拼接 SQL**,全面參數化防注入
  3. 大量寫入用 `MySqlBulkLoader` (LOAD DATA INFILE) 而非逐筆 Insert
  4. 留意 `MySqlException.Number` 對應官方錯誤碼表進行精準異常處理
copyright © 萬盛學電腦網 all rights reserved