Dapper怎么处理Oracle的REF CURSOR Dapper调用Oracle返回游标的SP

来源：这里教程网时间：2026-02-21 17:37:29 作者：

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<t></t>

方法。Dapper 会自动识别并读取游标结果集。

不能用匿名对象传参（如
new { p_result = ... }
），必须用
DynamicParameters
或原生
OracleParameter[]

Query<t></t>
必须指定泛型类型（如
User
），字段名需与查询列名（或别名）大小写一致（Oracle 默认大写，建议 SQL 中用双引号或别名统一） 示例代码：

using (var conn = new OracleConnection(connStr))
{
  var p = new OracleParameter("p_result", OracleDbType.RefCursor) { Direction = ParameterDirection.Output };
  var users = conn.Query<User>(
      "GET_USERS", 
      param: new[] { p }, 
      commandType: CommandType.StoredProcedure
  ).ToList();
}

处理多个 REF CURSOR 或复杂场景

一个存储过程可返回多个游标（多个

OUT SYS_REFCURSOR

参数），此时需用

QueryMultiple

+ 多次

Read<t>()</t>

：

为每个游标定义独立的
OracleParameter
，方向均为
Output
调用
conn.QueryMultiple(...)
，然后按顺序调用
multi.Read<t1>()</t1>
、
multi.Read<t2>()</t2>
注意：Oracle 驱动要求所有 RefCursor 参数必须放在参数列表末尾，且顺序与 SP 定义一致

若需动态 SQL 或 PL/SQL 块（非预存 SP），可用