【C# .NET】Oracle数据库连接的坑之传入parameters参数名SQL语句中的参数变量名不匹配（顺序不一致）的问题

问题描述

有一个user表，需要修改id为10086的用户的姓名和年龄，在C#的后台这样写：

using (IDbConnection db = DapperFactory.GetConnection(Enums.MyDbType.Oracle, @"User ID=czj;Password=123456;Data Source=(DESCRIPTION = (ADDRESS_LIST= (ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))) (CONNECT_DATA = (SERVICE_NAME = orcl)))"))
 {
	db.Open();
	var command=(OracleCommand)db.CreateCommand();
	string sql1 = @"update name from user set name=:name,age=:age where id =:id";
    OracleParameter[] paramList = new OracleParameter[]
	{
	   new OracleParameter(":id",OracleType.Int32,"10086",ParameterDirection.Input),
	   new OracleParameter(":name", OracleDbType.Varchar2, "小明", ParameterDirection.Input),
	   new OracleParameter(":age",OracleType.Int32,"20",ParameterDirection.Input)	                
	 };
	 command.CommandType = CommandType.Text;
     command.Parameters.AddRange(paramList);
     var effectRows=command.ExecuteScalar();
 }
   

当执行的时候，会出现报错，原因是在默认情况下，传入的参数是根据其数组顺序与SQL依次出现的变量进行映射的，如上述：传入的参数的顺序依次为：:id,:name,:age；它们依次对应的sql语句的变量为：name,age,id。即SQL语句为：update name from user set name=:id,age=:name where id =:age。很明显，参数与sql的变量对应不上。那么如何解决这个问题呢？这里有两个方法可以解决。

解决方法

方法1——利用BindByName

上述例子连接oracle数据库的类用到了Oracle.DataAccess命名空间提供的类：ODP.NET。ODP.NET是Oracle官方提供用于.NET连接Oracle数据库的一个类（微软官方自带的System.Data.OracleClient也可进行连接数据库，ODP.NET是和OracleClient有差异的¹）。而这个类里的OracleCommand.BindByName就是用于设置传入参数与SQL语句中的变量名的关系的，官网是这样描述BindByName的：

Returns true if the parameters are bound by name; returns false if the parameters are bound by position.²

解释（我的理解）：BindByName方法用于Oracle Sql的参数绑定（根据SQL的变量名与参数一一对应） 当BindByName=true时，则参数名与SQL语句中的变量名一一对应；当BindByName=false时，传入的参数是根据其数组顺序与SQL依次出现的变量名一一对应的。
在默认情况下，BindByName=false（所以就会出现上述问题了）。
所以，上述问题代码只需加上这个：

command.BindByName=true;

方法2——修改参数的顺序

只需把传入的参数数组顺序修改成与SQL的变量逐一对应即可。
如上述例子代码可修改为：

OracleParameter[] paramList = new OracleParameter[]
{
	new OracleParameter(":name", OracleDbType.Varchar2, "小明", ParameterDirection.Input),
	new OracleParameter(":age",OracleType.Int32,"20",ParameterDirection.Input)	  
    new OracleParameter(":id",OracleType.Int32,"10086",ParameterDirection.Input),               
};

参考文章如下：

---

1. Comparing the Microsoft .NET Framework 1.1 Data Provider for Oracle and the Oracle Data Provider for .NET ↩︎

2. Data Provider for .NET Developer’s Guide ↩︎