.NET中大型項目開發必備(7)--ORM資料庫通路技術

前言：本系列文章，旨在講述研發一個中大型項目所需要了解的一系列“基本構件”，并提供這些“基本構件”的【最簡單】、【最快速】使用方法！！（并不深究技術原理）本系列文章适合有初/中級.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中大型項目開發必備(7)--ORM資料庫通路技術

繼續閱讀

ms sqlserver常用sql語句

對自己發展的一些思考

Debug時檢測到Loaderlock的解決辦法

淺談MFC圖示

.NET程式員的技能分析參考V1.0(有附件)

asp.net AspNetpager的用法

在angularjs中通過ts編寫時，如何添加中英文轉換

金蝶雲星空即時庫存查詢SQL語句SQLServer

msdn 訪談錄之C＃程式設計二

使用Windbg調試.Net應用程式

部署.net平台的應用程式

Robot Framework配置發送郵件功能

解決"T-SQL無法附加到程序"錯誤的補充,T-SQLcan not attach to process

II6 IIS7 下 asp.net的生命周期 ASP.NET Application Life Cycle Overview for IIS 5.0 and 6.0

2010年終總結--技術篇

如何成為一名.net 工程師?