.NET中大型项目开发必备(7)--DataAccess数据库访问技术

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

 

支持.Net/.Net Core/.Net Framework，可以部署在Docker, Windows, Linux, Mac。

使用Sql语句操作数据库，是应用程序的基础必备知识。

本文要介绍的主角DeveloperSharp框架中的DataAccess数据库访问技术，提供了一种在.Net下使用Sql【快速+高效】操作各类数据库的工具，在IDataAccess接口中被实现（它比ADO.NET要简化、易用很多） 

 

IDataAccess所在的命名空间是：DeveloperSharp.Framework.QueryEngine（需从NuGet引用DeveloperSharp包）

它主要提供了如下四大功能：

（1）     执行Sql语句

（2）     执行Sp存储过程

（3）     创建参数(输入/输出/返回)

（4）     事务

它初始化的代码如下：

若是在.Net Core环境下，代码如下：

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

   //在Startup.cs或Program.cs文件中进行
   Services.AddTransient<IDataAccess>((t) => {
       DatabaseInfo DIF;
       DIF.DatabaseType = DatabaseType.SQLServer; //设置数据库类型
       DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123";
       return DataAccessFactory.Create(DIF);
   });

若是在.Net Framework环境下，代码如下：

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、等）之间透明切换！（某些第三方工具在创建参数时不需要指定具体类型，虽然是简化了，但某些情况下是会出错的）

 

优势：通过对DatabaseType属性的设定，提供了对所有种类数据库的支持（包括：MySql、Oracle、PostgreSQL、SqlServer、Sqlite、Firebird、达梦、以及人大金仓KingbaseES、神舟通用, 南大通用, 翰高, Access、等）

 

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(Async)
声明：int SqlExecuteNonQuery(string cmdText)
用途：执行Sql命令文本，返回受影响的行数
参数：（1）string  cmdText     -- Sql命令文本
返回：int    --受影响的行数

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SpExecuteDataset(Async)
声明：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(Async)
声明：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    --命令参数数组
返回：（无）

 

【附注】：下载示例均已成功运行通过。但有些辅助设置需要自己调整。技术支持+获取更多宝贵资源：请微信扫描文末二维码，备注“进群”！

 

推荐阅读

posted on 2022-01-20 02:24  DeveloperSharp  阅读(1334)  评论(0)  编辑  收藏  举报

导航