.NET集成DeveloperSharp操作Sql Server数据库

沙雕剧本杀

支持.Net/.Net Core/.Net Framework，可以部署在Docker, Windows, Linux, Mac。
本文提供了一种结合“原生Sql+轻量级ORM”操作各类数据库的工具。该工具几乎只使用了一个方法/函数，却实现了几乎所有的数据操作功能。它已成功应用到了人工智能、产业互联网、智慧医疗、等多个大型项目上。
 
此工具在IDataAccess接口中提供。 
IDataAccess所在的命名空间是：DeveloperSharp.Framework.QueryEngine（需从NuGet引用DeveloperSharp包）
它主要提供了如下四大功能：
（1）     执行Sql语句
（2）     执行Sp存储过程
（3）     创建参数(输入/输出/返回)
（4）     事务
它初始化的代码如下：

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

1. using DeveloperSharp.Framework.QueryEngine;
2. --------------------------
4.    //在Startup.cs或Program.cs文件中进行
5.    Services.AddTransient<IDataAccess>((t) => {
6.        DatabaseInfo DIF;
7.        DIF.DatabaseType = DatabaseType.SQLServer; //设置数据库类型
8.        DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123";
9.        return DataAccessFactory.Create(DIF);
10.    });

复制代码

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

1. using DeveloperSharp.Framework.QueryEngine;
2. --------------------------
4.    DatabaseInfo DIF;
5.    DIF.DatabaseType = DatabaseType.SQLServer; //设置数据库类型
6.    DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123";
7.    IDataAccess IDA = DataAccessFactory.Create(DIF);

复制代码

注意：通过对DatabaseType属性的设定，提供了对所有种类数据库的支持（包括：MySql、Oracle、PostgreSQL、SqlServer、Sqlite、Firebird、达梦、以及人大金仓KingbaseES、神舟通用, 南大通用, 翰高, Access、等）
 
【示例1：查询】
下面，首先直接给出一个“查询多数据+选出单数据+参数”的使用示例，代码如下：

1.    //查询多数据
2.    var Students1 = IDA.SqlExecute<stu>("select * from t_Student");
4.    //查询多数据（带参数）
5.    var Students2 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", new { IdMin = 2, LikeName = "%周%" });
6.    //另一种写法1
7.    var IdMin = IDA.CreateParameterInput("IdMin", DbType.Int32, 2);
8.    var LikeName = IDA.CreateParameterInput("LikeName", DbType.String, 50, "%周%");
9.    var Students3 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", LikeName, IdMin);
10.    //另一种写法2
11.    var Students4 = IDA.SqlExecute<stu>("select * from t_Student").Where(t => t.Id > 2 && t.Name.Contains("周"));
13.    //选出单数据
14.    var OneStudent = Students2.FirstOrDefault();

复制代码

其中stu实体类代码如下形式：

1.     //此实体类中的Id、Name、Age、Birth、MyLevel属性名，要与数据表中的字段名一一对应
2.     public class stu
3.     {
4.         public int? Id { get; set; }//数据库中该字段若存在Null值，类型后需要加问号?
5.         public string Name { get; set; }
6.         public int? Age { get; set; }
7.         public DateTime? Birth { get; set; }
8.         public Level? MyLevel { get; set; }//也可以使用枚举，会自动转换
9.     }
11.     public enum Level
12.     {
13.         Student=100,//学生
14.         Teacher=200,//老师
15.         Manager=300,//管理员
16.         Principle=400//校长
17.     }

复制代码

注意：（1）DbType类型的命名空间是System.Data
           （2）若没有定义stu实体类，也可以用dynamic替代
 
【示例2：分页】
承接上面“示例1”的代码，若我们要对Students1、Students2进行分页操作（比如：每页20条，取出第5页），相关代码如下：

1. using DeveloperSharp.Extension;//调用“分页功能”需要引用此命名空间
2. --------------------------
4.    var Page1 = Students1.PagePartition(20, 5);
5.    var Page2 = Students2.PagePartition(20, 5);
7.    //一气呵成的写法
8.    var Page3 = IDA.SqlExecute<stu>("select * from t_Student").PagePartition(20, 5);

复制代码

分页后获得的PagePiece对象中所包含的各类属性/参数，可参看这篇文章：高效分页
 
【示例3：增/删/改】
前面谈完“查询”，我们接下来谈谈“增/删/改”的使用方式，下面是一个“修改数据+参数+事务”的使用示例：

1.    try
2.    {
3.        //开启事务
4.        IDA.TransactionBegin();
6.        //修改数据（多语句）
7.        int affectedRows1 = IDA.SqlExecute("insert into t_Student(Name,Age)values('ww','96');update t_Student set Age=100 where Id=1006");
9.        //修改数据（带参数）
10.        int affectedRows2 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@N,@A)", new { N = "孙悟空", A = 200 });
11.        //另一种写法
12.        var NewAge = IDA.CreateParameterInput("NewAge", DbType.Int32, 200);
13.        var NewName = IDA.CreateParameterInput("NewName", DbType.String, 50, "孙悟空");
14.        int affectedRows3 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@NewName,@NewAge)", NewName, NewAge);
16.        //完成事务
17.        IDA.TransactionCommit();
18.    }
19.    catch
20.    {
21.        //回滚事务
22.        IDA.TransactionRollBack();
23.    }

复制代码

 
【示例4：输出参数】
前面几个示例都只用到了“输入参数”，下面我们看看“输出参数”怎么使用，示例代码如下：

1.    var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//此项为输出参数
2.    var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//此项为输出参数
4.    //以下sql语句混杂了多个“输入”与“输出”参数，注意看
5.    IDA.SqlExecute("insert into Friend(Birth,Name,height)values(@B,@N,@h);" +
6.        "select @TotalCount=count(*) from Friend;" +
7.        "select @MyName=Name from Friend where Id=@Id",
8.        new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 },
9.        op1, op2);
11.    int tc = Convert.ToInt32(op1.Value);
12.    string mn = op2.Value.ToString();

复制代码

 
【示例5：存储过程】
最后，我们来谈谈如何调用存储过程。我们创建一个存储过程，它带有输入、输出、返回三种类型的参数，代码如下：

1. CREATE PROCEDURE Test5
2.     @B as datetime,
3.     @N as nvarchar(50),
4.     @h as float,
5.     @TotalCount as int output,
6.     @MyName as nvarchar(50) output,
7.     @Id as int
8. AS
9. BEGIN
10.     insert into Friend(Birth,Name,height)values(@B,@N,@h);
11.     select @TotalCount=count(*) from Friend;
12.     select @MyName=Name from Friend where Id=@Id;
13.     return @TotalCount+100;
14. END

复制代码

调用该存储过程的示例代码如下：

1.    var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//输出参数
2.    var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//输出参数
3.    var op3 = IDA.CreateParameterReturn();//返回参数
5.    IDA.SpExecute("Test5", new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 }, op1, op2, op3);
7.    int tc = Convert.ToInt32(op1.Value);
8.    string mn = op2.Value.ToString();
9.    int ret = Convert.ToInt32(op3.Value);

复制代码

 
学习+灵活使用以上5个示例，就能满足几乎所有的数据操作需求。
另外，你有没有发现，上述所有的数据操作几乎只用了一个方法来实现：SqlExecute/ SqlExecute
-----------------------
【后记】
        有读者问到：本“工具说明”文章过于简单，缺乏全面、细节功能的详细介绍，所以很难依据本文内容做全面学习及后续开发。
        回答如下：其实不然，原因有三。
               （1）有一定数据库开发经验的人应该能看出，本文介绍的内容，已经能满足绝大多数情况下数据库操作的功能需求。
               （2）不像其它第三方工具有很多非标的自定义语法（这些“自定义语法”需要单独学习，而且往往并不符合微软规范），本工具顺应了原生.Net/C#、Linq、Sql语言的协调性（从几个示例就能看出），所以无需付出更多学习时间，自己动手简单用一用，各种功能就能马上实现。
                 举例：本文示例中并没有给出对结果集进行“排序操作”的代码。但你若会用Linq，顺应的应该马上能猜出如何进行排序？
               （3）已有读者依据本文内容把技术采用到了具体项目上。
----------------------- 
IDataAccess内功能方法详细说明（辅助参考）：

1. SqlExecute<T>  (异步为:SqlExecuteAsync<T>)
2. 声明：IEnumerable<T> SqlExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
3. 用途：执行Sql语句(Select类)
4. 参数：（1）string  cmdText              --  Sql语句
5.      （2）params IDataParameter[] Params --  参数组
6. 返回：IEnumerable<T> --  多数据结果集
8. SqlExecute<T>  (异步为:SqlExecuteAsync<T>)
9. 声明：IEnumerable<T> SqlExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
10. 用途：执行Sql语句(Select类)
11. 参数：（1）string  cmdText              --  Sql语句
12.      （2）object InputParams            --  输入参数对象
13.      （3）params IDataParameter[] Params --  参数组
14. 返回：IEnumerable<T> --  多数据结果集
16. SqlExecute  (异步为:SqlExecuteAsync)
17. 声明：int SqlExecute(string cmdText, params IDataParameter[] Params)
18. 用途：执行Sql语句(Insert/Update/Delete类)
19. 参数：（1）string  cmdText              --  Sql语句
20.      （2）params IDataParameter[] Params --  参数组
21. 返回：int --  受影响的行数
23. SqlExecute  (异步为:SqlExecuteAsync)
24. 声明：int SqlExecute(string cmdText, object InputParams, params IDataParameter[] Params)
25. 用途：执行Sql语句(Insert/Update/Delete类)
26. 参数：（1）string  cmdText              --  Sql语句
27.      （2）object InputParams            --  输入参数对象
28.      （3）params IDataParameter[] Params --  参数组
29. 返回：int --  受影响的行数
31. SpExecute<T>  (异步为:SpExecuteAsync<T>)
32. 声明：IEnumerable<T> SpExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
33. 用途：执行Sp存储过程(Select类)
34. 参数：（1）string  cmdText              --  Sp存储过程名
35.      （2）params IDataParameter[] Params --  参数组
36. 返回：IEnumerable<T> --  多数据结果集
38. SpExecute<T>  (异步为:SpExecuteAsync<T>)
39. 声明：IEnumerable<T> SpExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
40. 用途：执行Sp存储过程(Select类)
41. 参数：（1）string  cmdText              --  Sp存储过程名
42.      （2）object InputParams            --  输入参数对象
43.      （3）params IDataParameter[] Params --  参数组
44. 返回：IEnumerable<T> --  多数据结果集
46. SpExecute  (异步为:SpExecuteAsync)
47. 声明：int SpExecute(string cmdText, params IDataParameter[] Params)
48. 用途：执行Sp存储过程(Insert/Update/Delete类)
49. 参数：（1）string  cmdText              --  Sp存储过程名
50.      （2）params IDataParameter[] Params --  参数组
51. 返回：int --  受影响的行数
53. SpExecute  (异步为:SpExecuteAsync)
54. 声明：int SpExecute(string cmdText, object InputParams, params IDataParameter[] Params)
55. 用途：执行Sp存储过程(Insert/Update/Delete类)
56. 参数：（1）string  cmdText              --  Sp存储过程名
57.      （2）object InputParams            --  输入参数对象
58.      （3）params IDataParameter[] Params --  参数组
59. 返回：int --  受影响的行数

复制代码

 

来源:https://www.cnblogs.com/digital-college/p/18079750
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！