參數化 SQL 是防止 SQL 注入、處理特殊字符(如單引號、二進制數據)的標準做法。但不同數據庫提供程序對參數標記符、命名規則、綁定順序有顯著差異,踩坑在所難免。本文總結四大主流數據庫的參數化實戰規律。
| 數據庫 | 提供程序 | 參數標記 | 命名規則 | 綁定順序 |
|---|---|---|---|---|
| SQL Server | System.Data.SqlClient | @ | @paramName | 按名稱匹配,順序無關 |
| Oracle | System.Data.OracleClient / ODP.NET | : | :paramName | 按名稱匹配,順序無關 |
| MySQL | MySql.Data / Connector/NET | ? / @ | ?paramName 或 @paramName | 5.0+ 存儲過程用 ?,參數化 SQL 建議用 @ 但須按聲明順序添加 |
| Access | System.Data.OleDb | ? | 無名稱,僅位置佔位符 | 嚴格按 SQL 中出現順序添加參數 |
觀察發現:參數化 SQL 中的參數前綴,與該數據庫存儲過程參數聲明前綴完全一致。
: 開頭 → 參數化 SQL 用 :name。@ 開頭 → 參數化 SQL 用 @name。? 開頭 → 參數化 SQL 用 ?name(或 @name 但須按順序)。?。string sql = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)"; // SQL Server
// string sql = "INSERT INTO Users (Name, Email) VALUES (:Name, :Email)"; // Oracle
using (var cmd = conn.CreateCommand()) {
cmd.CommandText = sql;
cmd.Parameters.AddWithValue("@Name", "張三"); // 或 :Name
cmd.Parameters.AddWithValue("@Email", "zhang@example.com");
cmd.ExecuteNonQuery();
}
string sql = "INSERT INTO Users (Name, Email) VALUES (?, ?)";
using (OleDbCommand cmd = new OleDbCommand(sql, conn)) {
// 必須按 Name、Email 順序添加
cmd.Parameters.AddWithValue("?", "李四");
cmd.Parameters.AddWithValue("?", "li@example.com");
cmd.ExecuteNonQuery();
}
string sql = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
using (MySqlCommand cmd = new MySqlCommand(sql, conn)) {
// 雖然用 @Name,但底層按添加順序綁定
cmd.Parameters.AddWithValue("@Name", "王五");
cmd.Parameters.AddWithValue("@Email", "wang@example.com");
cmd.ExecuteNonQuery();
}
ParameterDirection.Output 參數必須在輸入參數之後添加。OracleParameter 需顯式指定 OracleType 避免類型推斷錯誤。記住「參數前綴 = 存儲過程參數前綴」這一規律,配合針對性代碼模板,即可在異構數據庫環境中安全、高效地使用參數化查詢,徹底告別 SQL 注入隱患。