.NET/C#大型项目研发必备(7)--ORM数据库访问技术

前言：本系列文章适合有初/中级.NET知识的同学阅读。
（1）本系列文章，旨在讲述研发一个中大型项目所需要了解的一系列“基本构件”，并提供这些“基本构件”的【最简单】、【最快速】使用方法！！（并不深究技术原理）
（2）通过阅读本系列文章，能让你在正规“项目研发”方面快速入门+进阶，并能达成“小团队构建大网站”的目的。
（3）本系列文章采用的技术，已成功应用到人工智能、产业互联网、社区电商、游戏、金融风控、智慧医疗、等项目上。

限时下载：
DeveloperSharp.dll组件
DeveloperSharp.dll组件

常见的ORM技术（比如：Entity Framework，Dapper，SqlSugar，NHibernate，等…），它们不是在做Sql语句的程序化变种，就是在做Sql语句的面向对象化。缺点显而易见：把简单的Sql语句复杂化、不伦不类、不符合标准的各家自定义语法格式、无统一标准难以大规模推广应用…
而ADO.NET也存在操作复杂、不同类型数据库（SqlServer、MySql、Oracle、等）操作代码需要重构等缺点。

本文要介绍的主角DeveloperSharp框架中的ORM数据库访问技术，则巧妙的规避了上述各种缺点，提供了一套折中且完善的解决方案，在IDataAccess接口中被实现。

IDataAccess所在的命名空间是：DeveloperSharp.Framework.QueryEngine。
它主要提供了如下四大功能：
（1） 执行Sql语句
（2） 执行Sp存储过程
（3） 创建参数(输入/输出/返回)
（4） 事务
它初始化的代码如下：

using DeveloperSharp.Framework.QueryEngine;
--------------------------

   DatabaseInfo DIF;
   DIF.DatabaseType = DatabaseType.SQLServer;
   DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123";
   IDataAccess IDA = DataAccessFactory.Create(DIF);

下面给出一个结合“Sql语句+参数+事务”的使用示例，代码如下：

            try
            {
                //开启事务
                IDA.TransactionBegin();

                //执行带参数的Sql语句
                var newQuantity = IDA.CreateParameterInput("newQuantity", DbType.Int32, 506);
                var newName = IDA.CreateParameterInput("newName", DbType.String, 50, "帽子");
                IDA.SqlExecuteNonQuery("update t_Order set Quantity=@newQuantity where Id=1", newQuantity);
                IDA.SqlExecuteNonQuery("update t_Order set Quantity=@newQuantity,Name=@newName  where Id=3", newQuantity, newName);

                //完成事务
                IDA.TransactionCommit();
            }
            catch
            {
                //回滚事务
                IDA.TransactionRollBack();
            }

注意：创建参数时使用DbType类型，就是为了能在不同类型数据库（SqlServer、MySql、Oracle、等）之间透明切换！

IDataAccess内拥有的详细功能方法说明如下：

DatabaseType
声明：DatabaseType DatabaseType{get;}
用途：获取数据库类型
返回：DatabaseType 	--  数据库类型枚举

ConnectionString
声明：string ConnectionString{get;}
用途：获取数据库链接字符串
返回：string	--  数据库链接字符串

CreateParameterInput
声明：IDataParameter CreateParameterInput(string name, DbType type, int size, object val)
用途：创建输入参数
参数：（1）string name      --  参数名
     （2）DbType type   --  参数类型
	 （3）int size		-- 参数大小
	 （4）object val		--参数值
返回：IDataParameter 	--  输入参数

CreateParameterInput
声明：IDataParameter CreateParameterInput(string name, DbType type, object val)
用途：创建输入参数
参数：（1）string name      --  参数名
     （2）DbType type   --  参数类型
	 （3）object val		--参数值
返回：IDataParameter 	--  输入参数

CreateParameterOutput
声明：IDataParameter CreateParameterOutput(string name, DbType type, int size)
用途：创建输出参数
参数：（1）string name	--参数名
	 （2）DbType type	--参数类型
	 （3）int size	--参数大小
返回：IDataParameter    --  输出参数

CreateParameterOutput
声明：IDataParameter CreateParameterOutput(string name, DbType type)
用途：创建输出参数
参数：（1）string name	--参数名
	 （2）DbType type	--参数类型
返回：IDataParameter    --  输出参数

CreateParameterReturn()
声明：IDataParameter CreateParameterReturn()
用途：创建返回参数
参数：（无）
返回：IDataParameter	--  返回参数

TransactionBegin
声明：void TransactionBegin()
用途：开启事务
参数：（无）
返回：（无）

TransactionCommit
声明：void TransactionCommit()
用途：完成事务
参数：（无）
返回：（无）

TransactionRollBack
声明：void TransactionRollBack
用途：回滚事务
参数：（无）
返回：（无）

SqlExecuteNonQuery
声明：int SqlExecuteNonQuery(string cmdText)
用途：执行Sql命令文本，返回受影响的行数
参数：（1）string  cmdText	 -- Sql命令文本
返回：int	--受影响的行数

SqlExecuteNonQuery
声明：int SqlExecuteNonQuery(string cmdText , params IDataParameter[] cmdParameters)
用途：执行Sql命令文本，返回受影响的行数
参数：（1）string  cmdText	 -- Sql命令文本
	 （2）params IDataParameter[] cmdParameters	--命令参数数组
返回：int	--受影响的行数

SpExecuteNonQuery
声明：int SpExecuteNonQuery(string cmdText)
用途：执行Store Procedure命令文本，返回受影响的行数
参数：（1）string  cmdText	--Store Procedure命令文本
返回：int	--受影响的行数

SpExecuteNonQuery
声明：int SpExecuteNonQuery(string cmdText, params IDataParameter[] cmdParameters)
用途：执行Store Procedure命令文本，返回受影响的行数
参数：（1）string cmdText	-- Store Procedure命令文本
	 （2）params IDataParameter[] cmdParameters	--命令参数数组
返回：int		--受影响的行数

SqlExecuteReader
声明：IDataReader SqlExecuteReader(string cmdText)
用途：执行Sql命令文本，返回DataReader对象
参数：（1）string  cmdText	-- Sql命令文本
返回：IDataReader	-- DataReader对象

SqlExecuteReader
声明：IDataReader SqlExecuteReader (string cmdText, params IDataParameter[] cmdParameters)
用途：执行Sql命令文本，返回DataReader对象
参数：（1）string  cmdText	-- Sql命令文本
	 （2）params IDataParameter[] cmdParameters	--命令参数数组
返回：IDataReader	-- DataReader对象

SpExecuteReader
声明：IDataReader SpExecuteReader(string cmdText)
用途：执行Store Procedure命令文本，返回DataReader对象
参数：（1）string  cmdText	-- Store Procedure命令文本
返回：IDataReader	-- DataReader对象

SpExecuteReader
声明：IDataReader SpExecuteReader(string cmdText, params IDataParameter[] cmdParameters)
用途：执行Store Procedure命令文本，返回DataReader对象
参数：（1）string  cmdText	-- Store Procedure命令文本
	 （2）params IDataParameter[] cmdParameters	--命令参数数组
返回：IDataReader	-- DataReader对象

SqlExecuteScalar
声明：object SqlExecuteScalar(string cmdText)
用途：执行Sql命令文本，返回sum、avg、max等聚合函数计算出的值
参数：（1）string  cmdText	-- Sql命令文本
返回：object	--聚合函数计算出的值

SqlExecuteScalar
声明：object SqlExecuteScalar(string cmdText, params IDataParameter[] cmdParameters)
用途：执行Sql命令文本，返回sum、avg、max等聚合函数计算出的值
参数：（1）string  cmdText	-- Sql命令文本
	 （2）params IDataParameter[]  cmdParameters	--命令参数数组
返回：object	--聚合函数计算出的值

SpExecuteScalar
声明：object SpExecuteScalar(string cmdText)
用途：执行Store Procedure命令文本，返回sum、avg、max等聚合函数计算出的值
参数：（1）string  cmdText	-- Store Procedure命令文本
返回：object	--聚合函数计算出的值

SpExecuteScalar
声明：object SpExecuteScalar(string cmdText, params IDataParameter[] cmdParameters)
用途：执行Store Procedure命令文本，返回sum、avg、max等聚合函数计算出的值
参数：（1）string  cmdText	-- Store Procedure命令文本
	 （2）params IDataParameter[] cmdParameters	--命令参数数组
返回：object	--聚合函数计算出的值

SqlExecuteDataset
声明：void SqlExecuteDataset(string cmdText, DataSet ds)
用途：执行Sql命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Sql命令文本
	 （2）DataSet ds	--数据集对象
返回：（无）

SqlExecuteDataset
声明：void  SqlExecuteDataset(string cmdText, DataSet ds, string tableName)
用途：执行Sql命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Sql命令文本
	 （2）DataSet ds	--数据集对象
	 （3）string tableName	--数据集中的数据表名
返回：（无）

SqlExecuteDataset
声明：void SqlExecuteDataset(string cmdText, DataSet ds, params IDataParameter[] cmdParameters)
用途：执行Sql命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Sql命令文本
	 （2）DataSet ds	--数据集对象
	 （3）params IDataParameter[] cmdParameters	--命令参数数组
返回：（无）

SqlExecuteDataset
声明：void SqlExecuteDataset(string cmdText, DataSet ds, string tableName, params IDataParameter[] cmdParameters)
用途：执行Sql命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Sql命令文本
	 （2）DataSet ds	--数据集对象
	 （3）string tableName	--数据集中的数据表名
	 （4）params IDataParameter[] cmdParameters	--命令参数数组
返回：（无）

SpExecuteDataset
声明：void SpExecuteDataset(string cmdText, DataSet ds)
用途：执行Store Procedure命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Store Procedure命令文本
	 （2）DataSet ds	--数据集对象
返回：（无）

SpExecuteDataset
声明：void SpExecuteDataset(string cmdText, DataSet ds, string tableName)
用途：执行Store Procedure命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Store Procedure命令文本
	 （2）DataSet ds	--数据集对象
	 （3）string tableName	--数据集中的数据表名
返回：（无）

SpExecuteDataset
声明：void SpExecuteDataset(string cmdText, DataSet ds, params IDataParameter[] cmdParameters)
用途：执行Store Procedure命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Store Procedure命令文本
	 （2）DataSet ds	--数据集对象
	 （3）params IDataParameter[] cmdParameters	--命令参数数组
返回：（无）

SpExecuteDataset
声明：void SpExecuteDataset(string cmdText, DataSet ds, string tableName, params IDataParameter[] cmdParameters)
用途：执行Store Procedure命令文本，获取相应的DataSet数据集
参数：（1）string  cmdText	-- Store Procedure命令文本
	 （2）DataSet ds	--数据集对象
	 （3）string tableName	--数据集中的数据表名
	 （4）params IDataParameter[] cmdParameters	--命令参数数组
返回：（无）

【附注】：文章开头给出的下载示例，均已成功运行通过。但下载示例往往只包含“核心模板”内容，有些辅助内容需要自己建立/设置（比如：数据库创建、链接字符串设置、文件配置、路径设置、参数设定、等等…）。调式时若遇异常报错，请仔细阅读+理解本文。
也随时欢迎联系作者，微信扫描文末二维码，获取更多技术支持！

• .NET/C#大型项目研发必备(1)–UUID全球通用唯一识别码
• .NET/C#大型项目研发必备(2)–跨域访问
• .NET/C#大型项目研发必备(3)–数据库的负载均衡
• .NET/C#大型项目研发必备(4)–数据库的读写分离
• .NET/C#大型项目研发必备(5)–Web服务/WebApi的负载均衡
• .NET/C#大型项目研发必备(6)–IUtility工具介绍
• .NET/C#大型项目研发必备(7)–ORM数据库访问技术
• .NET/C#大型项目研发必备(8)–高效分页
• .NET/C#大型项目研发必备(9)–http请求调用(Post与Get)
• .NET/C#大型项目研发必备(10)–图片的裁剪、缩放、与加水印
• .NET/C#大型项目研发必备(11)–使用Redis缓存
• .NET/C#大型项目研发必备(12)–使用MQ消息队列
• .NET/C#大型项目研发必备(13)–ORM数据库访问技术(续)

如果文章对你有帮助，请点赞、收藏、关注（原创内容，欢迎转载，转载请注明出处）
出处：https://developersharp.blog.csdn.net/
主页：http://www.365ey.net/
【获取专业技术支持，点击下方名片联系作者】