三大接入模式總覽
| 維度 | Connector/NET (引用) | Web.config 引用 | ODBC (系統 DSN) |
| 核心組件 | MySql.Data.dll | MySql.Data.dll | MySQL ODBC Driver + System.Data.Odbc |
| 部署方式 | Bin 部署 / GAC 安裝 | Bin 部署 + web.config 註冊 | 機器級安裝驅動 + 配置 DSN |
| 代碼命名空間 | MySql.Data.MySqlClient | MySql.Data.MySqlClient | System.Data.Odbc |
| 連接字符串 | Server=...;Database=...;Uid=...;Pwd=...; | 同左 | DSN=名稱 或 Driver=...;Server=...; |
| 適用場景 | 標準 ASP.NET、.NET Core、控制台 | 無代碼後置頁面、老項目無侵入接入 | 跨數據庫異構、legacy 系統、DBA 統一管理 DSN |
| 優點 | 原生性能最佳、功能全、強類型 | 不修改代碼即可啟用、部署靈活 | 統一連接池、屏蔽數據庫差異、DBA 可獨立調優 |
| 缺點 | 需引用特定 DLL、版本升級需重編譯 | 依賴 web.config、調試不直觀 | 性能損耗大、功能受限、部署依賴機器環境 |
模式一:程序集直接引用 —— 標準首選
步驟
- NuGet 安裝:
Install-Package MySql.Data(或下載 DLL 放入 Bin)。
- 引用命名空間:
using MySql.Data.MySqlClient;
- 代碼模板:
string connStr = "Server=127.0.0.1;Port=3306;Database=testdb;Uid=root;Pwd=123456;CharSet=utf8mb4;";
using (var conn = new MySqlConnection(connStr)) {
conn.Open();
using (var cmd = new MySqlCommand("SELECT * FROM users WHERE age > @age", conn)) {
cmd.Parameters.AddWithValue("@age", 18);
using (var reader = cmd.ExecuteReader()) {
while (reader.Read()) {
Console.WriteLine($"{reader["id"]}\t{reader["name"]}");
}
}
}
}
模式二:Web.config 註冊 —— 免代碼修改接入
web.config 關鍵節點
<configuration>
<system.data>
<DbProviderFactories>
<remove invariant="MySql.Data.MySqlClient" />
<add name="MySQL Data Provider"
invariant="MySql.Data.MySqlClient"
description=".Net Framework Data Provider for MySQL"
type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=8.0.33.0, Culture=neutral, PublicKeyToken=c5687fc88969c44d" />
</DbProviderFactories>
</system.data>
<connectionStrings>
<add name="MySqlConn"
connectionString="Server=127.0.0.1;Database=testdb;Uid=root;Pwd=123456;CharSet=utf8mb4;"
providerName="MySql.Data.MySqlClient" />
</connectionStrings>
</configuration>
代碼使用 DbProviderFactory(不依賴具體類型)
var factory = DbProviderFactories.GetFactory("MySql.Data.MySqlClient");
using (var conn = factory.CreateConnection()) {
conn.ConnectionString = ConfigurationManager.ConnectionStrings["MySqlConn"].ConnectionString;
conn.Open();
// 後續同模式一,但用 factory.CreateCommand() 等
}
模式三:ODBC 系統數據源 —— 異構統一接入
前置條件
- 下載安裝 MySQL Connector/ODBC(注意 32/64 位匹配應用程序池)。
- 控制面板 → 管理工具 → ODBC 數據源 (32/64 位) → 系統 DSN → 添加 → 選 MySQL ODBC Driver → 填寫 Server/Database/User/Password → 測試連接 → 確定。假設 DSN 名為
MySqlDSN。
代碼模板
using System.Data.Odbc;
string connStr = "DSN=MySqlDSN;"; // 或 "Driver={MySQL ODBC 8.0 Unicode Driver};Server=...;"
using (var conn = new OdbcConnection(connStr)) {
conn.Open();
using (var cmd = new OdbcCommand("SELECT * FROM users", conn))
using (var reader = cmd.ExecuteReader()) {
while (reader.Read()) { /* ... */ }
}
}
連接字符串關鍵參數速查
| 參數 | 說明 | 推薦值 |
| CharSet / CharacterSet | 字符集 | utf8mb4 (支持 Emoji) |
| Pooling | 連接池 | true (默認) |
| Min Pool Size / Max Pool Size | 池大小 | 0 / 100 (按需調整) |
| Connection Timeout | 連接超時(秒) | 15-30 |
| Default Command Timeout | 命令超時(秒) | 30-60 |
| SslMode | SSL 模式 | None / Preferred / Required |
| AllowLoadLocalInfile | LOAD DATA LOCAL | true (需服務端也開啟) |
最佳實踐建議
- 新項目首選 Connector/NET + 依賴注入:
services.AddDbContext / AddMySql (Pomelo.EntityFrameworkCore.MySql)。
- 參數化查詢:杜絕字符串拼接 SQL,防注入、利用計劃緩存。
- 連接池:保持
Pooling=true,使用 using 確保歸還。
- 異步 API:
OpenAsync/ExecuteReaderAsync 釋放線程,提升吞吐。
- 避免 ODBC** 除非跨數據庫異構或 DBA 強制統一 DSN 管理。
結語
C# 訪問 MySQL 三大模式各有定位:**Connector/NET 直連是性能與功能基準**,**Web.config 註冊適合老項目免改造接入**,**ODBC 服務於異構統一管理**。現代架構建議**直接依賴 MySql.Data / Pomelo EF Core**,配合依賴注入、異步、參數化查詢、連接池監控,構建高可用數據訪問層。