.Net執行SQL/儲存過程之易用輕量工具

王者天涯發表於2022-12-20
SQL儲存過程

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

 

由於該工具近來被廣東省數個公司2B專案採用，且表現穩定，得到良好驗證，故在此推薦出來。

此工具在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);

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

 

【示例1：查詢】

下面，首先直接給出一個“查詢多資料+選出單資料+引數”的使用示例，程式碼如下：

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

   //查詢多資料（帶引數）
   var Students2 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", new { IdMin = 2, LikeName = "%周%" });
   //另一種寫法1
   var IdMin = IDA.CreateParameterInput("IdMin", DbType.Int32, 2);
   var LikeName = IDA.CreateParameterInput("LikeName", DbType.String, 50, "%周%");
   var Students3 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", LikeName, IdMin);
   //另一種寫法2
   var Students4 = 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欄位名對應

注意：（1）DbType型別的名稱空間是System.Data

           （2）若沒有定義stu實體類，也可以用dynamic替代

 

【示例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);

分頁後獲得的PagePiece物件中所包含的各類屬性/引數，可參看這篇文章：高效分頁

 

【示例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");

       //修改資料（帶引數）
       int affectedRows2 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@N,@A)", new { N = "孫悟空", A = 200 });
       //另一種寫法
       var NewAge = IDA.CreateParameterInput("NewAge", DbType.Int32, 200);
       var NewName = IDA.CreateParameterInput("NewName", DbType.String, 50, "孫悟空");
       int affectedRows3 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@NewName,@NewAge)", NewName, NewAge);

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

 

【示例4：輸出引數】

前面幾個示例都只用到了“輸入引數”，下面我們看看“輸出引數”怎麼使用，示例程式碼如下：

   var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//此項為輸出引數
   var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//此項為輸出引數

   //以下sql語句混雜了多個“輸入”與“輸出”引數，注意看
   IDA.SqlExecute("insert into Friend(Birth,Name,height)values(@B,@N,@h);" +
       "select @TotalCount=count(*) from Friend;" +
       "select @MyName=Name from Friend where Id=@Id",
       new { N = "楊小偉", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 },
       op1, op2);

   int tc = Convert.ToInt32(op1.Value);
   string mn = op2.Value.ToString();

 

【示例5：儲存過程】

最後，我們來談談如何呼叫儲存過程。我們建立一個儲存過程，它帶有輸入、輸出、返回三種型別的引數，程式碼如下：

CREATE PROCEDURE Test5
    @B as datetime,
    @N as nvarchar(50),
    @h as float,
    @TotalCount as int output,
    @MyName as nvarchar(50) output,
    @Id as int
AS
BEGIN
    insert into Friend(Birth,Name,height)values(@B,@N,@h);
    select @TotalCount=count(*) from Friend;
    select @MyName=Name from Friend where Id=@Id;
    return @TotalCount+100;
END

呼叫該儲存過程的示例程式碼如下：

   var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//輸出引數
   var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//輸出引數
   var op3 = IDA.CreateParameterReturn();//返回引數

   IDA.SpExecute("Test5", new { N = "楊小偉", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 }, op1, op2, op3);

   int tc = Convert.ToInt32(op1.Value);
   string mn = op2.Value.ToString();
   int ret = Convert.ToInt32(op3.Value);

 

學習+靈活使用以上5個示例，就能滿足幾乎所有的資料操作需求，且操作十分簡易。

 

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<T>
宣告：IEnumerable<T> SqlExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
用途：執行Sql語句(Select類)
引數：（1）string  cmdText              --  Sql語句
     （2）object InputParams            --  輸入引數物件
     （3）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 --  受影響的行數

SqlExecute
宣告：int SqlExecute(string cmdText, object InputParams, params IDataParameter[] Params)
用途：執行Sql語句(Insert/Update/Delete類)
引數：（1）string  cmdText              --  Sql語句
     （2）object InputParams            --  輸入引數物件
     （3）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<T>
宣告：IEnumerable<T> SpExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
用途：執行Sp儲存過程(Select類)
引數：（1）string  cmdText              --  Sp儲存過程名
     （2）object InputParams            --  輸入引數物件
     （3）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 --  受影響的行數

SpExecute
宣告：int SpExecute(string cmdText, object InputParams, params IDataParameter[] Params)
用途：執行Sp儲存過程(Insert/Update/Delete類)
引數：（1）string  cmdText              --  Sp儲存過程名
     （2）object InputParams            --  輸入引數物件
     （3）params IDataParameter[] Params --  引數組
返回：int --  受影響的行數

 原文連結：http://www.developersharp.cc/content13.html

 

【附註】：文中所有示例均已成功執行透過！技術交流/支援+更多精彩乾貨，請立刻關注下方公眾號！

 

 

相關文章