Dapper 通过 Oracle.ManagedDataAccess 驱动支持 REF CURSOR,需用 OracleParameter 显式声明 OracleDbType.RefCursor 输出参数,并调用 Query 或 QueryMultiple 处理结果。

Dapper 本身不原生支持 Oracle 的 REF CURSOR,但可以通过适配 Oracle 官方驱动(Oracle.ManagedDataAccess)配合手动处理参数来调用返回游标的存储过程。
确保使用 Oracle.ManagedDataAccess 驱动
Dapper 依赖底层 ADO.NET 提供的参数类型支持。Oracle 的 REF CURSOR 在 .NET 中对应的是 OracleDbType.RefCursor,只有 Oracle 官方的 Oracle.ManagedDataAccess(OMDP)才完整支持该类型。不要用旧的 System.Data.OracleClient(已废弃)或第三方驱动。
- 安装 NuGet 包:
Oracle.ManagedDataAccess - 连接字符串需启用游标支持(默认开启,无需额外配置)
- 确认项目目标框架兼容(.NET Core 3.1+ / .NET 5+ 推荐用 OMDP 3.x+)
在存储过程中正确定义 REF CURSOR 输出参数
Oracle 存储过程需显式声明 OUT SYS_REFCURSOR 参数,并在过程中用 OPEN ... FOR 打开它。例如:
CREATE OR REPLACE PROCEDURE GET_USERS(p_result OUT SYS_REFCURSOR) AS BEGIN OPEN p_result FOR SELECT id, name, email FROM users WHERE status = 'A'; END;
注意:Dapper 不解析 PL/SQL 块,只调用已编译好的存储过程,所以必须提前在数据库中创建好带 OUT SYS_REFCURSOR 的 SP。
用 Dapper 调用并映射 REF CURSOR 结果
关键在于:用 OracleParameter 显式指定 OracleDbType.RefCursor 和 ParameterDirection.Output,再将该参数传给 Dapper 的 Query 方法。Dapper 会自动识别并读取游标结果集。
- 不能用匿名对象传参(如
new { p_result = ... }),必须用DynamicParameters或原生OracleParameter[] -
Query必须指定泛型类型(如User),字段名需与查询列名(或别名)大小写一致(Oracle 默认大写,建议 SQL 中用双引号或别名统一) - 示例代码:
using (var conn = new OracleConnection(connStr))
{
var p = new OracleParameter("p_result", OracleDbType.RefCursor) { Direction = ParameterDirection.Output };
var users = conn.Query(
"GET_USERS",
param: new[] { p },
commandType: CommandType.StoredProcedure
).ToList();
}
处理多个 REF CURSOR 或复杂场景
一个存储过程可返回多个游标(多个 OUT SYS_REFCURSOR 参数),此时需用 QueryMultiple + 多次 Read:
- 为每个游标定义独立的
OracleParameter,方向均为Output - 调用
conn.QueryMultiple(...),然后按顺序调用multi.Read、() multi.Read() - 注意:Oracle 驱动要求所有 RefCursor 参数必须放在参数列表末尾,且顺序与 SP 定义一致
若需动态 SQL 或 PL/SQL 块(非预存 SP),可用 CommandType.Text + BEGIN ... END; 块,但需确保块内正确打开游标并赋值给参数变量。
基本上就这些。核心是驱动支持 + 参数类型明确 + Dapper 版本兼容。不复杂但容易忽略 Oracle 参数方向和类型匹配细节。










