SqlSugar+SqlServer+NetCore3.1 入門案例

十年河東，十年河西，莫欺少年窮html

學無止境，精益求精git

開發過.NetCore 的都知道，微軟的EF框架EFCore對DataTable並非特別友好，在整個EFCore框架中，直接寫SQL語句彷佛不太行，所以，在咱們的項目中就有必要對數據庫操做進行擴展。github

自上篇博客 netCore 引用第三方ORM中間件-Dapper 後，我在項目架構時將Dapper引入到數據庫操做層，使用後，我發現Dapper對 IQueryable 的支持幾乎沒有，【也可能有，可是我沒發現】，這對於追求性能的開發人員來講難以接受，所以，今天引入sqlSugar。sql

Dapper的查詢方法：數據庫

由上圖可知，Dapper 支持IEnumerable ，IEnumerable 和 IQueryable 的區別是前者將數據所有加載到內存，後者是將須要的數據加載到內存。所以，IE比較浪費內存，IQ相對而言是按需開闢內存，所以，我選擇IQ，雖然說IQ在某些性能方面比不上IE，但如今的系統，大多都是數據量龐大的。架構

如今進入正題，sqlSugar的搭建。app

俗話說：工欲善其事必先利其器，所以，在項目搭建以前，咱們須要準備一個小的數據庫。框架

簡單的數據庫，只有兩張表，ide

一、打開VS，新建一個netCore3.1的控制檯程序，並新增兩個類庫，以下：工具

二、SugarEntity爲實體層，實體層代碼有項目或工具生成，固然，也能夠手寫。注：須要引入：SqlASugar V 5.0.0.19 版本。

SugarContext爲數據上下文層，用於操做數據庫，代碼也能夠經過項目或工具生成，固然，也能夠手寫。注：須要引入：SqlASugar V 5.0.0.19 版本和 Newtonsoft.Json V 12.0.3 及 System.Data.SqlClient V 4.8.2 版本

SugarCore爲控制檯輸出層，須要引入SqlASugar V 5.0.0.19 版本

關於上述的【可經過項目/工具生成】你們可參考：http://www.codeisbug.com/Doc/8/1123 或者直接去CSDN 上下載相關工具/項目：https://download.csdn.net/download/wolongbb/12997789

這裏，將代碼生成工具截圖以下：

工具僅能生成實體類，並不能生成上下文層

重要的話，再說一遍，不論是那一層，咱們均可以經過手動寫代碼的形式實現

三、更層次代碼：

3.一、實體層Entity代碼以下

Student 實體層

using System; using System.Linq; using System.Text; using SqlSugar; namespace Sugar.Enties { ///<summary>
    ///
    ///</summary>
    [SugarTable("Student")] public partial class Student { public Student(){ } /// <summary>
           /// Desc: /// Default: /// Nullable:False /// </summary>           
           [SugarColumn(IsPrimaryKey=true)] public string StudentID {get;set;} /// <summary>
           /// Desc: /// Default: /// Nullable:True /// </summary>           
           public string GradID {get;set;} /// <summary>
           /// Desc: /// Default: /// Nullable:True /// </summary>           
           public string StudentName {get;set;} /// <summary>
           /// Desc: /// Default: /// Nullable:True /// </summary>           
           public string StudentSex {get;set;} /// <summary>
           /// Desc: /// Default: /// Nullable:True /// </summary>           
           public DateTime? CreateTime {get;set;} } }

View Code

StudentGrad 實體層

using System; using System.Linq; using System.Text; using SqlSugar; namespace Sugar.Enties { ///<summary>
    ///
    ///</summary>
    [SugarTable("StudentGrad")] public partial class StudentGrad { public StudentGrad(){ } /// <summary>
           /// Desc: /// Default: /// Nullable:False /// </summary>           
           [SugarColumn(IsPrimaryKey=true)] public string GradID {get;set;} /// <summary>
           /// Desc: /// Default: /// Nullable:True /// </summary>           
           public string GradName {get;set;} /// <summary>
           /// Desc: /// Default: /// Nullable:True /// </summary>           
           public DateTime? CreateTime {get;set;} } }

View Code

3.二、上下文層代碼以下：

using SqlSugar; using Sugar.Enties; using System; using System.Collections.Generic; using System.Linq; using System.Linq.Expressions; namespace SugarContext { public class SugarDbContext<T> where T : class, new() { public SugarDbContext() { Db = new SqlSugarClient(new ConnectionConfig() { ConnectionString = "Data Source=LAPTOP-P5GVS4UM;Initial Catalog=StudentDB;Integrated Security=True", DbType = DbType.SqlServer, InitKeyType = InitKeyType.Attribute,//從特性讀取主鍵和自增列信息
                IsAutoCloseConnection = true,//開啓自動釋放模式和EF原理同樣我就很少解釋了
 }); //調式代碼 用來打印SQL 
            Db.Aop.OnLogExecuting = (sql, pars) => { Console.WriteLine(sql + "\r\n" + Db.Utilities.SerializeObject(pars.ToDictionary(it => it.ParameterName, it => it.Value))); Console.WriteLine(); }; } //注意：不能寫成靜態的
        public SqlSugarClient Db;//用來處理事務多表查詢和複雜的操做
        public SimpleClient<T> CurrentDb { get { return new SimpleClient<T>(Db); } }//用來操做當前表的數據

        public SimpleClient<StudentGrad> StudentGradDb { get { return new SimpleClient<StudentGrad>(Db); } }//用來處理StudentGrad表的經常使用操做
        public SimpleClient<Student> StudentDb { get { return new SimpleClient<Student>(Db); } }//用來處理Student表的經常使用操做


        /// <summary>
        /// 獲取全部 /// </summary>
        /// <returns></returns>
        public virtual List<T> GetList() { return CurrentDb.GetList(); } /// <summary>
        /// 根據表達式查詢 /// </summary>
        /// <returns></returns>
        public virtual List<T> GetList(Expression<Func<T, bool>> whereExpression) { return CurrentDb.GetList(whereExpression); } /// <summary>
        /// 根據表達式查詢分頁 /// </summary>
        /// <returns></returns>
        public virtual List<T> GetPageList(Expression<Func<T, bool>> whereExpression, PageModel pageModel) { return CurrentDb.GetPageList(whereExpression, pageModel); } /// <summary>
        /// 根據表達式查詢分頁並排序 /// </summary>
        /// <param name="whereExpression">it</param>
        /// <param name="pageModel"></param>
        /// <param name="orderByExpression">it=>it.id或者it=>new{it.id,it.name}</param>
        /// <param name="orderByType">OrderByType.Desc</param>
        /// <returns></returns>
        public virtual List<T> GetPageList(Expression<Func<T, bool>> whereExpression, PageModel pageModel, Expression<Func<T, object>> orderByExpression = null, OrderByType orderByType = OrderByType.Asc) { return CurrentDb.GetPageList(whereExpression, pageModel, orderByExpression, orderByType); } /// <summary>
        /// 根據主鍵查詢 /// </summary>
        /// <returns></returns>
        public virtual T GetById(dynamic id) { return CurrentDb.GetById(id); } /// <summary>
        /// 根據主鍵刪除 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Delete(dynamic id) { return CurrentDb.Delete(id); } /// <summary>
        /// 根據實體刪除 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Delete(T data) { return CurrentDb.Delete(data); } /// <summary>
        /// 根據主鍵刪除 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Delete(dynamic[] ids) { return CurrentDb.AsDeleteable().In(ids).ExecuteCommand() > 0; } /// <summary>
        /// 根據表達式刪除 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Delete(Expression<Func<T, bool>> whereExpression) { return CurrentDb.Delete(whereExpression); } /// <summary>
        /// 根據實體更新，實體須要有主鍵 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Update(T obj) { return CurrentDb.Update(obj); } /// <summary>
        ///批量更新 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Update(List<T> objs) { return CurrentDb.UpdateRange(objs); } /// <summary>
        /// 插入 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Insert(T obj) { return CurrentDb.Insert(obj); } /// <summary>
        /// 批量 /// </summary>
        /// <param name="id"></param>
        /// <returns></returns>
        public virtual bool Insert(List<T> objs) { return CurrentDb.InsertRange(objs); } //自已擴展更多方法 
 } }

View Code

3.三、控制檯輸出層代碼以下：

using SqlSugar; using Sugar.Enties; using SugarContext; using System; namespace SugarCore { class Program { static void Main(string[] args) { SugarDbContext<Student> db = new SugarDbContext<Student>(); var Lst_Qb = db.Db.Queryable<Student>().ToList(); var lst = db.GetList(); var list = db.Db.Queryable<Student, StudentGrad>((st, sc) => new object[] { JoinType.Inner,st.GradID==sc.GradID}) .Select<ViewModel>().ToList(); foreach (var item in list) { Console.WriteLine(item.GradName + item.StudentName); } Console.ReadLine(); } } class ViewModel { public string StudentID { get; set; } public string GradID { get; set; } public string StudentName { get; set; } public string StudentSex { get; set; } public DateTime? CreateTime { get; set; } public string GradName { get; set; } } }

View Code

輸出結果爲：

由上圖可知，使用SqlSugar 框架時，Context層能夠直接記錄執行的SQL語句。

以上即是整個Sugar項目的搭建，固然，這都是基礎demo，如今說說經過項目來生成數據庫上下文層及實體層。

經過上述CSDN 能夠下載到該項目

：

項目中有生成步驟的詳細說明，摘抄以下：

### SoEasyPlatform 代碼生成器 ## 介紹 一款輕量級開源的代碼生成器，相對較動軟代碼生成器而言要輕量的多，支持多種數據庫，所用到dll組件也都在github有源碼，代碼很是的簡單有點基礎的看源碼能夠把生成的項目改爲自已的風格。 ## 特點 該代碼生成器最大的特色就三個簡單 ，無需安裝，生成的代碼 簡單而且有教學用例，還有就是調試和修改模版簡單。 ## 使用步驟 1.從上面的地址下載 SoEasyPlatform到本地 2.解壓項目 點擊SoEasyPlatform.sln打開項目，從新生成項目會自動下載NUGET 文件 3.配置三個參數 const SqlSugar.DbType dbType = DbType.SqlServer;//數據庫類型

const string connectionString = "server=.;uid=sa;pwd=@jhl85661501;database=SqlSugar4XTest";//鏈接字符串

const string SolutionName = "SoEasyPlatform";//解決方案名稱
　　

4.F5運行 5.完成 咱們發現兩個類庫已經添加到解決方案下面了,而且相關的dll的類庫引用也幫咱們作好了，很是方便，數據庫有改動後F5刷新就行了。 執行完成沒發現有類庫加進來，關掉解決方案從新打開即可以了 ## 如何使用生成的代碼開發項目 1.新建一個項目 Web項目或者控制檯均可以 2.引用生成的類庫 3.代碼以下 StudentManager m = new StudentManager();

關於Sugar的性能，直接看官方文檔便可，聽說比EF好的多，比Dapper也要好的多。

插入比賽：

更新比賽：

查詢比賽：

等等吧，總之SqlSugar人性化的設計加優良的性能贏得了個人心。

愛你， SqlSugar

@天才臥龍的博客