Oracle带OUT参数的函数必须用CommandType.StoredProcedure调用,不能用Text;需显式声明ReturnValue和OUT参数,指定OracleDbType及Size;执行后先读返回值再读OUT参数;函数体禁止DML操作,否则ORA-14551报错。

Oracle函数带OUT参数时,C#必须用OracleCommand.CommandType = CommandType.StoredProcedure
Oracle里声明为 FUNCTION xxx RETURN ... 但内部含 OUT 参数的,本质仍是存储过程行为——Oracle .NET 驱动(Oracle.ManagedDataAccess)不支持用 CommandType.Text 调用带 OUT 的函数。强行用 SELECT xxx(...) FROM DUAL 会报错:ORA-06553: PLS-306: wrong number or types of arguments。
实操要点:
-
CommandType必须设为CommandType.StoredProcedure,哪怕函数名在数据库里是 FUNCTION - 函数名要完整带 schema,如
"SCOTT"."GET_EMP_INFO",大小写敏感(取决于建库时是否加双引号) - 返回值需显式添加一个
OracleParameter,Direction = ParameterDirection.ReturnValue
OUT参数必须用OracleDbType显式指定类型和大小
Oracle 的 VARCHAR2、NUMBER、DATE 等类型在 .NET 里没有自动映射规则,尤其 VARCHAR2 类型的 OUT 参数若不设 Size,常触发 ORA-06502: PL/SQL: numeric or value error。
常见配置方式:
-
VARCHAR2OUT 参数:设置Size = 200(按函数定义的最大长度,不能小于它) -
NUMBEROUT 参数:用OracleDbType.Int32或OracleDbType.Decimal,避免用Int64导致精度截断 -
DATEOUT 参数:直接用OracleDbType.Date,不要用DateTime类型传参 - 所有 OUT 参数的
Value初始值必须设为DBNull.Value,否则驱动可能忽略绑定
调用后必须先读 ReturnValue,再读 OUT 参数
Oracle 驱动执行完 ExecuteNonQuery() 后,返回值和 OUT 参数不会自动“就位”;顺序错误会导致读到空值或旧值。
正确顺序:
- 调用
cmd.ExecuteNonQuery() - 立即读取
cmd.Parameters[0].Value(ReturnValue 对应的参数) - 再依次读取各
OUT参数的.Value - 若函数有
RETURN NUMBER,且你又定义了ReturnValue参数,则.Value是函数返回值,不是 OUT 参数内容
示例关键片段:
var cmd = new OracleCommand("SCOTT.GET_EMP_INFO", conn);
cmd.CommandType = CommandType.StoredProcedure;
cmd.Parameters.Add(new OracleParameter("return_val", OracleDbType.Int32) { Direction = ParameterDirection.ReturnValue });
cmd.Parameters.Add(new OracleParameter("p_emp_id", OracleDbType.Int32) { Value = 7369 });
cmd.Parameters.Add(new OracleParameter("p_name", OracleDbType.Varchar2) { Direction = ParameterDirection.Output, Size = 100 });
cmd.Parameters.Add(new OracleParameter("p_hire_date", OracleDbType.Date) { Direction = ParameterDirection.Output });
<p>cmd.ExecuteNonQuery();</p><p>int ret = (int)cmd.Parameters["return_val"].Value; // 先读返回值
string name = (string)cmd.Parameters["p_name"].Value; // 再读 OUT
DateTime hire = (DateTime)cmd.Parameters["p_hire_date"].Value;</p>函数体里不能有 DML 语句,否则调用时抛 ORA-14551
如果 Oracle 函数体内执行了 INSERT/UPDATE/DELETE,即使加了 PRAGMA AUTONOMOUS_TRANSACTION,C# 调用时仍大概率报 ORA-14551: cannot perform a DML operation inside a query——因为驱动底层仍以查询上下文发起调用。
解决路径只有两个:
- 把函数改写成
PROCEDURE,并在 C# 中保持同样调用方式(CommandType.StoredProcedure) - 若必须保留函数签名,确保函数体只做计算、查表(用
SELECT ... INTO)、拼字符串等纯读操作
这个限制容易被忽略,尤其当函数在 SQL*Plus 里能跑通,但 C# 调不通时,第一反应往往是参数问题,其实根源在函数副作用。


















