前言:本系列文章,旨在讲述研发一个中大型项目所需要了解的一系列“基本构件”,并提供这些“基本构件”的【最简单】、【最快速】使用方法!!(并不深究技术原理) 本系列文章适合有初/中级.NET知识的同学阅读。
相关下载:
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中大型项目开发必备(1)–UUID全球通用唯一识别码
- .NET中大型项目开发必备(2)–CORS跨域访问
- .NET中大型项目开发必备(3)–数据库的负载均衡
- .NET中大型项目开发必备(4)–数据库的读写分离
- .NET中大型项目开发必备(5)–Web服务/WebApi的负载均衡
- .NET中大型项目开发必备(6)–IUtility工具介绍
- .NET中大型项目开发必备(7)–ORM数据库访问技术
- .NET中大型项目开发必备(8)–高效分页
- .NET中大型项目开发必备(9)--http请求调用(Post与Get)
- .NET中大型项目开发必备(10)--图片的裁剪、缩放、与加水印
- .NET中大型项目开发必备(11)--使用Redis缓存
- .NET中大型项目开发必备(12)--使用MQ消息队列
如果文章对你有帮助,请点赞、收藏、关注(原创内容,欢迎转载,转载请注明出处) 有疑问想获取专业技术支持?请扫描左侧微信二维码联系作者 出处:https://www.cnblogs.com/DeveloperSharp/ 本文采用「CC BY 4.0」知识共享协议进行许可,转载请注明作者及出处。 |