高效簡單的.Net資料庫“訪問+操作”技術

本文技術源自外企，並已在多個世界500強大型項目開發中運用。

本文適合有初步C#、Linq、Sql知識的同學閱讀。

相關技術在IDataAccess介面中提供。

IDataAccess所在的命名空間是：DeveloperSharp.Framework.QueryEngine。（需事先從nuget引用DeveloperSharp）

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

（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);

註意：（1）通過對DatabaseType屬性的設定，提供了對各不同種類資料庫的支持（包括：MySql、Oracle、PostgreSQL、SqlServer、Sqlite、Firebird、達夢、以及人大金倉KingbaseES、神舟通用, 南大通用, 翰高, Access、等）

（2）.NET6.0的版本支持以上所有資料庫；.NET4.5的版本直接支持Oracle與Sql Server，其它則需要通過設定ODBC來支持。

【示例1：查詢】

下麵，首先直接給出一個“查詢多數據+選出單數據+參數”的使用示例，代碼如下：

   //查詢多數據
   var Students1 = IDA.SqlExecute<stu>("select * from t_Student");

   //查詢多數據（帶參數）
   var IdMin = IDA.CreateParameterInput("IdMin", DbType.Int32, 2);
   var LikeName = IDA.CreateParameterInput("LikeName", DbType.String, 50, "%周%");
   var Students2 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", IdMin, LikeName);
   //另一種寫法
   var Students3 = IDA.SqlExecute<stu>("select * from t_Student").Where(t => t.Id > 2 && t.Name.Contains("周"));

   //選出單數據
   var OneStudent = Students2.FirstOrDefault();

其中stu實體類代碼如下形式：

public class stu
{
        public int Id { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }
}
//此實體類中的Id、Name、Age屬性名，要與數據表中的Id、Name、Age欄位名對應

註意：創建參數時使用DbType類型，就是為了能在不同類型資料庫（SqlServer、MySql、Oracle、等）之間快速切換！

【示例2：分頁】

承接上面“示例1”的代碼，若我們要對Students1、Students2進行分頁操作（比如：每頁20條，取出第5頁），相關代碼如下：

using DeveloperSharp.Extension;//調用“分頁功能”需要引用此命名空間
--------------------------

   var Page1 = Students1.PagePartition(20, 5);
   var Page2 = Students2.PagePartition(20, 5);

   //一氣呵成的寫法
   var Page3 = IDA.SqlExecute<stu>("select * from t_Student").PagePartition(20, 5);

【示例3：增/刪/改】

前面談完“查詢”，我們接下來談談“增/刪/改”的使用方式，下麵是一個“修改數據+參數+事務”的使用示例：

   try
   {
       //開啟事務
       IDA.TransactionBegin();

       //修改數據（多語句）
       int affectedRows1 = IDA.SqlExecute("insert into t_Student(Name,Age)values('ww','96');update t_Student set Age=100 where Id=1006");

       //修改數據（帶參數）
       var NewAge = IDA.CreateParameterInput("NewAge", DbType.Int32, 200);
       var NewName = IDA.CreateParameterInput("NewName", DbType.String, 50, "孫悟空");
       int affectedRows2 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@NewName,@NewAge)", NewName, NewAge);

       //完成事務
       IDA.TransactionCommit();
   }
   catch
   {
       //回滾事務
       IDA.TransactionRollBack();
   }

【示例4：其它】

最後，我們給出一個“聚合函數+輸出參數”的使用示例，代碼如下：

   var IdMax = IDA.CreateParameterInput("IdMax", DbType.Int32, 20);
   var TotalCount = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//此項為輸出參數
   var Students3 = IDA.SqlExecute<stu>("select @TotalCount=count(*) from t_Student where Id<@IdMax", TotalCount, IdMax);
   int tc = (int)TotalCount.Value;

靈活學習+使用以上4個示例，就能滿足幾乎所有的數據操作需求。

另外，你有沒有發現，上述所有的數據操作幾乎只用了一個方法來實現：SqlExecute/ SqlExecute<T>

 【附註】：文中所有示例均已成功運行通過！！技術交流/支持，請微信掃描二維碼，備註“進群”！

IDataAccess內功能方法詳細說明（輔助參考）：

SqlExecute<T>
聲明：IEnumerable<T> SqlExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
用途：執行Sql語句(Select類)
參數：（1）string  cmdText              --  Sql語句
     （2）params IDataParameter[] Params --  參數組
返回：IEnumerable<T> --  多數據結果集


SqlExecute
聲明：int SqlExecute(string cmdText, params IDataParameter[] Params)
用途：執行Sql語句(Insert/Update/Delete類)
參數：（1）string  cmdText              --  Sql語句
     （2）params IDataParameter[] Params --  參數組
返回：int --  受影響的行數

SpExecute<T>
聲明：IEnumerable<T> SpExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
用途：執行Sp存儲過程(Select類)
參數：（1）string  cmdText              --  Sp存儲過程名
     （2）params IDataParameter[] Params --  參數組
返回：IEnumerable<T> --  多數據結果集

SpExecute
聲明：int SpExecute(string cmdText, params IDataParameter[] Params)
用途：執行Sp存儲過程(Insert/Update/Delete類)
參數：（1）string  cmdText              --  Sp存儲過程名
     （2）params IDataParameter[] Params --  參數組
返回：int --  受影響的行數