在.net 6中通过dapper调用返回游标的oracle存储过程,核心做法是使用 oraclerefcursor 类型作为参数接收结果集,并在执行时指定命令类型为存储过程。具体操作是定义一个 dynamicparameters 对象,添加一个方向为 parameterdirection.output、类型为 oraclerefcursor 的参数,调用 query 方法并传入该参数,dapper会自动将游标内容映射到指定的实体类或动态对象列表中。

如何配置Oracle连接与参数以支持游标输出?
要成功获取游标数据,必须确保使用了正确的Oracle数据提供程序(如 Oracle.ManagedDataAccess.Core),并将参数明确声明为输出类型。关键在于使用 OracleRefCursor 结构体来承载游标引用,而不是普通的字符串或整数类型。这样做后,Dapper的 Query 扩展方法能够识别这个特殊类型,并从底层驱动中读取多行结果。

using System;
using System.Data;
using System.Linq;
using Dapper;
using Oracle.ManagedDataAccess.Client;
using Oracle.ManagedDataAccess.Types;
public class EmployeeService
{
private readonly string _connectionString;
public EmployeeService(string connectionString)
{
_connectionString = connectionString;
}
public dynamic GetEmployeesByDepartment(int departmentId)
{
using (var connection = new OracleConnection(_connectionString))
{
connection.Open();
var parameters = new DynamicParameters();
parameters.Add("p_dept_id", departmentId, DbType.Int32, ParameterDirection.Input);
parameters.Add("p_cursor", dbType: DbType.Object, direction: ParameterDirection.Output);
// 假设存储过程名为 GET_EMPLOYEES_BY_DEPT
// 语法示例: CREATE OR REPLACE PROCEDURE GET_EMPLOYEES_BY_DEPT(p_dept_id IN NUMBER, p_cursor OUT SYS_REFCURSOR)
var sql = "BEGIN GET_EMPLOYEES_BY_DEPT(:p_dept_id, :p_cursor); END;";
// 使用 Query 方法自动映射游标结果
var employees = connection.Query<Employee>(sql, parameters, commandType: CommandType.Text).ToList();
return employees;
}
}
}
public class Employee
{
public int Id { get; set; }
public string Name { get; set; }
public decimal Salary { get; set; }
}
上述代码定义了 Employee 类用于映射返回的数据列。调用 GetEmployeesByDepartment(10) 时,会执行存储过程并将结果集填充到 List<employee></employee> 中。注意 parameters.Add 中第二个参数名需与SQL中的绑定变量名一致,且方向必须为 Output。如果存储过程直接返回游标而不需要包裹在PL/SQL块中,也可以直接使用 CommandType.StoredProcedure 并省略 BEGIN...END; 包装,但某些Oracle版本对直接调用返回游标的存储过程有权限或语法限制,使用匿名块通常更稳妥。
如何处理游标映射时的类型转换与空值情况?
当存储过程返回的列类型与C#属性类型不完全匹配,或者存在NULL值时,Dapper默认行为可能抛出异常或返回null。解决方法是在实体类中使用可空类型(如 int?)或字符串类型来接收数值型字段,避免类型转换错误。对于NULL值,Dapper会自动将其转换为对应类型的null,无需额外处理,但需确保属性是可空的或引用类型。
using System;
using System.Collections.Generic;
using System.Data;
using Dapper;
using Oracle.ManagedDataAccess.Client;
using Oracle.ManagedDataAccess.Types;
public class OrderService
{
private readonly string _connectionString;
public OrderService(string connectionString)
{
_connectionString = connectionString;
}
public List<OrderDto> GetOrdersWithNullableFields(int orderId)
{
using (var connection = new OracleConnection(_connectionString))
{
connection.Open();
var parameters = new DynamicParameters();
parameters.Add("p_order_id", orderId, DbType.Int32, ParameterDirection.Input);
parameters.Add("p_cursor", dbType: DbType.Object, direction: ParameterDirection.Output);
var sql = "BEGIN GET_ORDER_DETAILS(:p_order_id, :p_cursor); END;";
// 映射到包含可空字段的DTO
var orders = connection.Query<OrderDto>(sql, parameters, commandType: CommandType.Text).ToList();
return orders;
}
}
}
public class OrderDto
{
public int OrderId { get; set; }
public string CustomerName { get; set; } // 引用类型,允许null
public DateTime? OrderDate { get; set; } // 可空值类型,处理数据库NULL
public decimal? TotalAmount { get; set; } // 可空decimal,防止NULL转decimal失败
}
在 OrderDto 中,TotalAmount 和 OrderDate 被定义为可空类型,这样即使Oracle数据库中这些字段为NULL,Dapper也能正确映射而不会引发 InvalidCastException。CustomerName 作为字符串引用类型,同样可以安全地接收NULL值。这种设计确保了数据访问层的健壮性,避免因数据不一致导致的运行时错误。若需验证,可插入一条 TotalAmount 为NULL的记录,调用 GetOrdersWithNullableFields 后检查返回对象的 TotalAmount.HasValue 是否为false。
基于输入参数departmentId为0时存储过程的行为是什么?
当输入参数 departmentId 为0时,存储过程通常会返回空结果集或根据内部逻辑过滤掉所有记录,具体取决于存储过程的实现。在Dapper层面,无论存储过程返回多少行,Query 方法都会返回一个空的 List<employee></employee>,因为没有任何数据可映射。这不会引发异常,只是集合长度为0。开发者应在业务层判断返回集合是否为空,以决定后续流程。


















