C#中带参数的MS Access INSERT命令报错：无效参数

核心原因：OleDb参数匹配规则与类型不兼容 #

OleDb提供程序（包括Access适配的版本）不支持按参数名称匹配，而是严格按照SQL语句中参数出现的顺序来匹配你添加的OleDbParameter。同时你的代码存在参数类型不匹配的问题，两者共同导致了「无效参数」错误。

具体问题与修复步骤 #

1. 日期参数类型错误
   你当前将UPDATE_DATE参数拼接成字符串传递：

   insertCommand.Parameters.AddWithValue("@updateday", $"{DateTime.Now.Year}-{DateTime.Now.Month}-{DateTime.Now.Day} 00:00:00");
   

   Access的日期字段需要直接传递DateTime类型，而非格式化字符串。改为：

   insertCommand.Parameters.AddWithValue("@updateday", DateTime.Now.Date);
   

2. 严格对齐参数顺序
   仔细核对SQL语句中参数出现的顺序，必须和调用AddWithValue的顺序完全一致：

   • SQL中的参数顺序：@ccode → @explain → @address1 → @address2 → @address3 → @city → @phone1 → @email → @taxoffice → @taxnumber → @updateday
   • 你当前的参数添加顺序是正确的，但要确保没有遗漏或多添加参数。

3. 改用?作为参数占位符（可选，更符合OleDb规范）
   OleDb官方推荐使用?作为参数占位符，而非命名参数，能避免名称混淆问题。修改后的SQL语句示例：

   insertCommand.CommandText = $"INSERT INTO CUSTOMER_CARDS ([CODE], [EXPLAIN], [GROUP_CODE], [CUSTOMER_TYPE], [CREDIT_TYPE], [PAY_TYPE], [PAY_PARAM], [EXTRE_TIME], [LICENCE_DATE], [ADRESS1], [ADRESS2], [ADRESS3], [CITY], [ZIP_CODE], [PHONE1], [PHONE2], [FAX], [E_MAIL], [URL], [TAX_OFFICE], [TAX_NUMBER], [SS_NO], [MARRIAGE_DATE], [BIRTH_DAY], [BIT_FLAG_INT], [BANK_NO], [BANK_NAME], [CREDIT_LIMIT], [REAL_LIMIT], [DISCOUNT], [DISCOUNT_TYPE], [DISCOUNT_LIMIT], [USING_SELL_PRICE], [NOTES], [BASEBONUS], [EARNEDBONUS], [UPDATE_DATE], [UPDATE_WHO], [UPDATE_MODE]) VALUES (?, ?, '1', '1', '', 0, 1, 0, '2000-01-01', ?, ?, ?, ?, '', ?, '', '', ?, '', ?, ?, '', '', '', 0, '', '', 0, 0, 0, 0, 0, 0, '', 0, 0, ?, '', 0)";
   

   保持参数添加顺序和?出现的顺序完全一致即可。

修复后的关键代码片段 #

using OleDbTransaction transaction = connection.BeginTransaction();
using OleDbCommand insertCommand = new() { Connection = connection, Transaction = transaction };
insertCommand.CommandText = $"INSERT INTO CUSTOMER_CARDS ([CODE], [EXPLAIN], [GROUP_CODE], [CUSTOMER_TYPE], [CREDIT_TYPE], [PAY_TYPE], [PAY_PARAM], [EXTRE_TIME], [LICENCE_DATE], [ADRESS1], [ADRESS2], [ADRESS3], [CITY], [ZIP_CODE], [PHONE1], [PHONE2], [FAX], [E_MAIL], [URL], [TAX_OFFICE], [TAX_NUMBER], [SS_NO], [MARRIAGE_DATE], [BIRTH_DAY], [BIT_FLAG_INT], [BANK_NO], [BANK_NAME], [CREDIT_LIMIT], [REAL_LIMIT], [DISCOUNT], [DISCOUNT_TYPE], [DISCOUNT_LIMIT], [USING_SELL_PRICE], [NOTES], [BASEBONUS], [EARNEDBONUS], [UPDATE_DATE], [UPDATE_WHO], [UPDATE_MODE]) VALUES (?, ?, '1', '1', '', 0, 1, 0, '2000-01-01', ?, ?, ?, ?, '', ?, '', '', ?, '', ?, ?, '', '', '', 0, '', '', 0, 0, 0, 0, 0, 0, '', 0, 0, ?, '', 0)";

insertCommand.Parameters.Clear();
insertCommand.Parameters.AddWithValue("?", musteri.MusteriVergiKimlikNo);
insertCommand.Parameters.AddWithValue("?", musteri.MusteriUnvan.Length > 30 ? musteri.MusteriUnvan.Substring(0, 30) : musteri.MusteriUnvan);
insertCommand.Parameters.AddWithValue("?", musteri.MusteriAdres.Length > 30 ? musteri.MusteriAdres.Substring(0, 30) : musteri.MusteriAdres);
insertCommand.Parameters.AddWithValue("?", musteri.MusteriAdres.Length > 30 ? musteri.MusteriAdres.Substring(30, Math.Min(30, musteri.MusteriAdres.Length - 30)) : "");
insertCommand.Parameters.AddWithValue("?", musteri.MusteriAdres.Length > 60 ? musteri.MusteriAdres.Substring(60, Math.Min(30, musteri.MusteriAdres.Length - 60)) : "");
insertCommand.Parameters.AddWithValue("?", musteri.MusteriSehir.Length > 20 ? musteri.MusteriSehir.Substring(0, 20) : musteri.MusteriSehir);
insertCommand.Parameters.AddWithValue("?", musteri.MusteriTelefon.Length > 25 ? musteri.MusteriTelefon.Substring(0, 25) : musteri.MusteriTelefon);
insertCommand.Parameters.AddWithValue("?", musteri.MusteriEmail.Length > 25 ? musteri.MusteriEmail.Substring(0, 25) : musteri.MusteriEmail);
insertCommand.Parameters.AddWithValue("?", "");
insertCommand.Parameters.AddWithValue("?", musteri.MusteriVergiKimlikNo.Length > 12 ? musteri.MusteriVergiKimlikNo.Substring(0, 12) : musteri.MusteriVergiKimlikNo);
insertCommand.Parameters.AddWithValue("?", DateTime.Now.Date);

await insertCommand.ExecuteNonQueryAsync();

为什么VB.NET可以正常运行？ #

VB.NET中OleDb参数匹配逻辑和C#一致，但你的VB.NET代码可能恰好参数顺序完全对应，且日期参数直接传递了DateTime类型，因此未触发错误。

内容的提问来源于stack exchange，提问作者Kadir Çorbacıoğlu