如何在.NET 6中通过Dapper调用返回游标的Oracle存储过程?

星强酱_3318

星强酱_3318

2026-11-19

204人浏览

原创

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

如何在.NET 6中通过Dapper调用返回游标的Oracle存储过程?

如何配置Oracle连接与参数以支持游标输出?

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

如何在.NET 6中通过Dapper调用返回游标的Oracle存储过程?

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>

上述代码定义了 Employee 类用于映射返回的数据列。调用 GetEmployeesByDepartment(10) 时,会执行存储过程并将结果集填充到 List 中。注意 parameters.Add 中第二个参数名需与SQL中的绑定变量名一致,且方向必须为 Output。如果存储过程直接返回游标而不需要包裹在PL/SQL块中,也可以直接使用 CommandType.StoredProcedure 并省略 BEGIN...END; 包装,但某些Oracle版本对直接调用返回游标的存储过程有权限或语法限制,使用匿名块通常更稳妥。

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载

如何处理游标映射时的类型转换与空值情况?

当存储过程返回的列类型与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></orderdto>

在 OrderDto 中,TotalAmount 和 OrderDate 被定义为可空类型,这样即使Oracle数据库中这些字段为NULL,Dapper也能正确映射而不会引发 InvalidCastException。CustomerName 作为字符串引用类型,同样可以安全地接收NULL值。这种设计确保了数据访问层的健壮性,避免因数据不一致导致的运行时错误。若需验证,可插入一条 TotalAmount 为NULL的记录,调用 GetOrdersWithNullableFields 后检查返回对象的 TotalAmount.HasValue 是否为false。

基于输入参数departmentId为0时存储过程的行为是什么?

当输入参数 departmentId 为0时,存储过程通常会返回空结果集或根据内部逻辑过滤掉所有记录,具体取决于存储过程的实现。在Dapper层面,无论存储过程返回多少行,Query 方法都会返回一个空的 List,因为没有任何数据可映射。这不会引发异常,只是集合长度为0。开发者应在业务层判断返回集合是否为空,以决定后续流程。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

5103

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

1031

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1349

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

7201

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3823

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

7180

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

10081

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1370

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1192

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程