Asp.Net 高性能ORM框架 SqlSugar.ORM 2.8

1、前言/Preface

SqlSugar从去年到现在已经一年了，版本从1.0升到了现在的2.8 ，这是一个稳定版本，有数家公司已经项目上线，在这里我将SqlSugar的功能重新整理成一篇新的贴子，希望大家喜欢。

公司团队项目、产品已经完全抛弃EF，SqlSugar定位不是ORM,而是为了方便的让你去写Sql。

媲美原生ADO.NET的性能、简洁的语法和支持Json 、Dynamic、 List<T>、 List<string[]>、 ValueType和 Dictionary 等多种类型的返回值有很多亮点。

GitHub下载地址：

MSSQL .NET 4.0+

https://github.com/sunkaixuan/SqlSugar

MSSQL .NET Core 版本

https://github.com/sunkaixuan/ASP_NET_CORE_ORM_SqlSugar

Sqlite .net4.0+

https://github.com/sunkaixuan/SqliteSugar

MYSQL .NET 4.0+

http://www.cnblogs.com/sunkaixuan/p/5747259.html

ORACLE.NET 4.0+

https://github.com/sunkaixuan/OracleSugar

ORACLE CORE ,MYSQL CORE,SQLITE CORE 待开发

最新更新：

3.0.02

可以设置生成实体的摘要

    var temSummary = ClassTemplate.ClassFieldSummaryTemplate;

批量添加别名表功能

     //批量设置别名表
     //db.ClassGenerating.ForeachTables(db, tableName =>
      //{
                //    db.AddMappingTable(new KeyValue() { Key = tableName.Replace("bbs.",""), Value =  tableName }); //key实体名，value表名
     //});

别名列功能

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NewTest.Dao;
using System.Data.SqlClient;
using SqlSugar;
namespace NewTest.Demos
{
    //别名列的功能
    public class MappingColumns : IDemos
    {

        public void Init()
        {
            Console.WriteLine("启动MappingColumns.Init");

            //全局设置
            using (var db = SugarFactory.GetInstance())
            {
                var list = db.Queryable<Student>().Where(it=>it.classId==1).ToList();
            }
        }

        public class Student
        {

            //id
            public int classId { get; set; }

            //name
            public string className { get; set; }

            //sch_id
            public int classSchoolId { get; set; }

            public int isOk { get; set; }
        }

        /// <summary>
        /// 全局配置别名列（不区分表）
        /// </summary>
        public class SugarConfigs
        {
            //key实体字段名 value表字段名 ，KEY唯一否则异常
            public static List<KeyValue> MpList = new List<KeyValue>(){
            new KeyValue(){ Key="classId", Value="id"},
            new KeyValue(){ Key="className", Value="name"},
            new KeyValue(){ Key="classSchoolId", Value="sch_id"}
            };
        }

        /// <summary>
        /// SqlSugar实例工厂
        /// </summary>
        public class SugarFactory
        {

            //禁止实例化
            private SugarFactory()
            {

            }
            public static SqlSugarClient GetInstance()
            {
                string connection = SugarDao.ConnectionString; //这里可以动态根据cookies或session实现多库切换
                var db = new SqlSugarClient(connection);
                //注意：只有启动属性映射才可以使用SetMappingColumns
                db.IsEnableAttributeMapping = true;
                db.SetMappingColumns(SugarConfigs.MpList);//设置关联列 (引用地址赋值，每次赋值都只是存储一个内存地址)
                return db;
            }
        }
    }
}

View Code

通过属性设置别名表和别名列和字段过滤

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NewTest.Dao;
using Models;
using System.Data.SqlClient;
using SqlSugar;
namespace NewTest.Demos
{
    //通过属性的方法设置别名表和别名字段（主键和自添列都无需设置 SQLSUGAR会帮你自动处理）
    //注意:【属性映射和 (SetMappingTables、SetMappingColumns)方式映射 2种选其中一，不清楚底层缓存机质不建议同时使用】
    public class AttributesMapping : IDemos
    {

        public void Init()
        {
            Console.WriteLine("启动AttributesMapping.Init");
            using (var db = DBManager.GetInstance())
            {

                //查询
                var list = db.Queryable<TestStudent>()
                    .Where(it => it.className.Contains("小")).OrderBy(it => it.classSchoolId).Select<V_Student>(it => new V_Student() { id = it.classId, name = it.className }).ToList();
                var list2 = db.Queryable<TestStudent>()
                    .JoinTable<TestSchool>((s1, s2) => s1.classSchoolId == s2.classId)
                    .OrderBy<TestSchool>((s1, s2) => s1.classId)
                    .Select<TestStudent, TestSchool, V_Student>((s1, s2) => new V_Student() { id = s1.classId, name = s1.className, SchoolName = s2.className }).ToList();

                //添加
                TestStudent s = new TestStudent();
                s.className = "属性名";
                s.classSchoolId = 1;
                var id = db.Insert(s);
                s.classId = id.ObjToInt();

                //更新
                db.Update(s);
                db.Update<TestStudent, int>(s, 100);
                db.Update<TestStudent>(s, it => it.classId == 100);
                db.SqlBulkReplace(new List<TestStudent>() { s });

                //删除
                db.Delete<TestStudent>(it => it.classId == 100);
            }
        }

        /// <summary>
        /// 属性只作为初始化映射，SetMappingTables和SetMappingColumns可以覆盖
        /// </summary>
        [SugarMapping(TableName = "Student")]
        public class TestStudent
        {

            [SugarMapping(ColumnName = "id")]
            public int classId { get; set; }

            [SugarMapping(ColumnName = "name")]
            public string className { get; set; }

            [SugarMapping(ColumnName = "sch_id")]
            public int classSchoolId { get; set; }

            public int isOk { get; set; }

            /// <summary>
            /// 数据库并没有这一列
            /// </summary>
            public string errorField { get; set; }
        }

 
        [SugarMapping(TableName = "School")]
        public class TestSchool
        {

            [SugarMapping(ColumnName = "id")]
            public int classId { get; set; }

            [SugarMapping(ColumnName = "name")]
            public string className { get; set; }

            public int AreaId = 1;
        }
    }

    public class DBManager
    {

        public static SqlSugarClient GetInstance()
        {
            var db = new SqlSugarClient(SugarDao.ConnectionString);
            db.IsEnableAttributeMapping = true;//启用属性映射
            db.IsIgnoreErrorColumns = true;//忽略非数据库列



            db.IsEnableLogEvent = true;//启用日志事件
            db.LogEventStarting = (sql, par) => { Console.WriteLine(sql + " " + par + "
"); };


            return db;
        }
    }
}

View Code

拉姆达支持了 contains

db.Update<School>(new { name = "蓝翔2" }, it => array.Contains(it.id))

添加了高性能批量更新

db.SqlBulkReplace

2.9.1.0

添加了SQL日志和监控功能

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NewTest.Dao;
using Models;
using System.Data.SqlClient;
using SqlSugar;

namespace NewTest.Demos
{
    //日志记录功能
    public class Log : IDemos
    {
       
        public void Init()
        {
            Console.WriteLine("启动Log.Init");
            using (var db = SugarDemoDao.GetInstance())
            {

                var a1 = db.Queryable<Student>().Where(it => it.id == 1).ToList();
                var a2 = db.Queryable<Student>().OrderBy(it => it.id).ToList();
            }
        }

        public class SugarConfigs
        {
            public static Action<string, string> LogEventStarting = (sql, pars) =>
            {
                Console.WriteLine("starting:" + sql + " " + pars);
                
                using (var db = SugarDemoDao.GetInstance())
                {
                    //日志记录件事件里面用到数据库操作 IsEnableLogEvent一定要为false否则将引起死循环，并且要新开一个数据实例 像我这样写就没问题。
                    db.IsEnableLogEvent = false;
                    db.ExecuteCommand("select 1");
                }
            };
            public static Action<string, string> LogEventCompleted = (sql, pars) =>
            {
                Console.WriteLine("completed:" + sql + " " + pars);
            };
        }

        /// <summary>
        /// SqlSugar
        /// </summary>
        public class SugarDemoDao
        {

            public static SqlSugarClient GetInstance()
            {
                var db = new SqlSugarClient(SugarDao.ConnectionString);
                db.IsEnableLogEvent = true;//启用日志事件
                db.LogEventStarting = SugarConfigs.LogEventStarting;
                db.LogEventCompleted = SugarConfigs.LogEventCompleted;
                return db;
            }
        }
    }
}

日志记录功能

大量语法优化

以前 .select<oldT,newT>(it=>newT{ id=it.id})可以写成.select<newT>(it=>newT{ id=it.id})

以前 .select<T,int>(it=>it.id)可以写成.select<int>(it=>it.id);

Join也进行了美化可以不用写第一个T

 //2表关联查询
                var jList = db.Queryable<Student>()
                .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) //默认left join
                .Where<School>((s1, s2) => s1.id == 1)
                .Select("s1.*,s2.name as schName")
                .ToDynamic();

                /*等于同于
                 SELECT s1.*,s2.name as schName 
                 FROM [Student]  s1 
                 LEFT JOIN [School]  s2 ON  s1.sch_id  = s2.id 
                 WHERE  s1.id  = 1 */

                //2表关联查询并分页
                var jList2 = db.Queryable<Student>()
                .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) //默认left join
                    //如果要用inner join这么写
                    //.JoinTable<School>((s1, s2) => s1.sch_id == s2.id ,JoinType.INNER)
                .Where<School>((s1, s2) => s1.id > 1)
                .OrderBy(s1 => s1.name)
                .Skip(10)
                .Take(20)
                .Select("s1.*,s2.name as schName")
                .ToDynamic();

                //3表查询并分页
                var jList3 = db.Queryable<Student>()
               .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) // left join  School s2  on s1.id=s2.id
               .JoinTable<School>((s1, s3) => s1.sch_id == s3.id) // left join  School s3  on s1.id=s3.id
               .Where<School>((s1, s2) => s1.id > 1)  // where s1.id>1
               .Where(s1 => s1.id > 0)
               .OrderBy<School>((s1, s2) => s1.id) //order by s1.id 多个order可以  .oderBy().orderby 叠加 
               .Skip(10)
               .Take(20)
               .Select("s1.*,s2.name as schName,s3.name as schName2")//select目前只支持这种写法
               .ToDynamic();


                //上面的方式都是与第一张表join，第三张表想与第二张表join写法如下
                List<V_Student> jList4 =
                 db.Queryable<Student>()
                 .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) // left join  School s2  on s1.id=s2.id
                 .JoinTable<School, Area>((s1, s2, a1) => a1.id == s2.AreaId)// left join  Area a1  on a1.id=s2.AreaId  第三张表与第二张表关联
                 .JoinTable<Area, School>((s1, a1, s3) => a1.id == s3.AreaId)// left join  School s3  on a1.id=s3.AreaId  第四第表第三张表关联
                 .JoinTable<School>((s1, s4) => s1.sch_id == s4.id) // left join  School s2  on s1.id=s4.id
                 .Select<School, Area, V_Student>((s1, s2, a1) => new V_Student { id = s1.id, name = s1.name, SchoolName = s2.name, AreaName = a1.name }).ToList();

JoinTable新写法

2.8.01设置不插入列

2.8.0.0 强化了 SELECT 新容器转换功能，以前只能 id=it.id 这种等值操作，现在支持了类型转换函数，另外还支持了外部传参和内部硬编码的写法

  //新容器转换函数的支持,例子外其它写法暂不支持 
                var f1 = db.Queryable<InsertTest>().Select<InsertTest, Student>(it => new Student()
                {
                    name = it.d1.ObjToString(),
                    id = it.int1.ObjToInt() // 支持ObjToXXX 所有函数

                }).ToList();

                var f2 = db.Queryable<InsertTest>().Select<InsertTest, Student>(it => new Student()
                {
                    name = Convert.ToString(it.d1),//支持Convet.ToXX所有函数
                    id = it.int1.ObjToInt(),
                    sex = Convert.ToString(it.d1),

                }).ToList();

                var f3 = db.Queryable<InsertTest>()
                    .JoinTable<InsertTest, InsertTest>((i1, i2) => i1.id == i2.id)
                    .Select<InsertTest, InsertTest, Student>((i1, i2) => new Student()
                {
                    name = Convert.ToString( i1.d1), //多表查询例子
                    id = i1.int1.ObjToInt( ),
                    sex = Convert.ToString( i2.d1 ),

                }).ToList();

                //Select 外部参数用法
                var f4 = db.Queryable<InsertTest>().Where("1=1", new { id = id + 100 }).Select<InsertTest, Student>(it => new Student()
               {
                   id = "@id".ObjToInt(), //取的是 id+100 的值
                   name = "张三",//内部参数可以直接写
                   sex = it.txt,
                   sch_id=it.id

               }).ToList();
                var f6 = db.Queryable<InsertTest>()
               .JoinTable<InsertTest, InsertTest>((i1, i2) => i1.id == i2.id)
               .Where("1=1", new { id = 100, name = "张三",isOk=true }) //外部传参给@id
               .Select<InsertTest, InsertTest, Student>((i1, i2) => new Student()
               {
                   name = "@name".ObjToString(), //多表查询例子
                   id = "@id".ObjToInt(),
                   sex = i2.txt,
                   sch_id = 1,
                   isOk = "@isOk".ObjToBool()

               }).ToList();

View Code

2.7.1.3 更新了SqlSugar所有的函数的备注、类的备注

OracleSugar已经上传NUGET GIT文章最下方有地址

2.7.08 支持了字典参数

List<Student> list2 = db.SqlQuery<Student>("select * from Student where id=@id", new { id = 1 }); 其中new { id = 1 }可以改成 Dictionary<string, object>(){{id,1}}

db.Update<School>(new { name = "蓝翔14" }, it => it.id == 14); 其中 new { name = "蓝翔14" } 可以改成 Dictionary<string, object>(){{name,"蓝翔14"}}

这样做有什么好处呢？动态权限的时候弱类型会比较好处理

2.7.1.0 JoinTable支持了字符串,可以做更复杂的查询例如：

using (SqlSugarClient db = SugarDao.GetInstance())
            {

                var childQuery = db.Queryable<Area>().Where("id=@id").Select(it => new { id=it.id }).ToSql();//创建子查询SQL
                string childTableName=string.Format("({0})",childQuery.Key);//将SQL语句用()包成表


                var queryable = db.Queryable<Student>()
                 .JoinTable<Student, School>((s1, s2) => s1.sch_id == s2.id) 
                 .JoinTable(childTableName, "a1", "a1.id=s2.areaid", new { id = 1 }, JoinType.INNER)
                 .OrderBy(s1 => s1.id);
              

                //SELECT * FROM  ( 
                
                                     //SELECT newid = s1.id, studentName = s1.name, schoolName = s2.name, areaName = a1.name ,row_index=ROW_NUMBER() OVER(ORDER BY s1.id ASC ) FROM [Student]   s1 
                                     //LEFT JOIN School  s2 ON  ( s1.sch_id  = s2.id )    
                                     //INNER JOIN (SELECT *  FROM [Area]   WHERE 1=1  AND id=@id   ) a1 ON a1.id=s2.areaid    WHERE 1=1
                                //
                                //) t WHERE t.row_index BETWEEN 1 AND 200

                 var list= queryable.Select<Student, School, Area, classNew>((s1, s2, a1) => new classNew { newid = s1.id, studentName = s1.name, schoolName = s2.name, areaName = a1.name })
                     .ToPageList(0,200);

                 var count=queryable.Count();
            }

joinTable高级查询

优点：

1、高性能，达到原生最高水准，比SqlHelper性能要高，比Dapper快30% 比EF快50%

2、支持多种数据库，sql版本更新最快，其它会定期更新，可以在多种数据库用一种编程方式

3、支持.net Core

4、支持多库并行计算

5、带有实体生成函数和T4模版生成实体

6、无需任何配置，还你一个干净的model，可以没有主键，也可以有多个主键，或者多个自增列

2、功能介绍/Product function introduction

查询/Search

1、Queryable用于拉姆达操作数据库

2、SqlQuery用于执行SQL和存储过程

3、Sqlable一种更新近SQL的写法

1、Queryable 用于拉姆达表达式操作（支持Join多表） / Select single table or view

 using (var db = SugarDao.GetInstance())
 {


                //---------Queryable<T>,扩展函数查询---------//

                //针对单表或者视图查询

                //查询所有
                var student = db.Queryable<Student>().ToList();
                var studentDynamic = db.Queryable<Student>().ToDynamic();
                var studentJson = db.Queryable<Student>().ToJson();

                //查询单条
                var single = db.Queryable<Student>().Single(c => c.id == 1);
                //查询单条没有记录返回空对象
                var singleOrDefault = db.Queryable<Student>().SingleOrDefault(c => c.id == 11111111);
                //查询单条没有记录返回空对象
                var single2 = db.Queryable<Student>().Where(c => c.id == 1).SingleOrDefault();

                //查询第一条
                var first = db.Queryable<Student>().Where(c => c.id == 1).First();
                var first2 = db.Queryable<Student>().Where(c => c.id == 1).FirstOrDefault();

                //取11-20条
                var page1 = db.Queryable<Student>().Where(c => c.id > 10).OrderBy(it => it.id).Skip(10).Take(10).ToList();

                //取11-20条  等于 Skip(pageIndex-1)*pageSize).Take(pageSize) 等于  between (pageIndex-1)*pageSize and  pageIndex*pageSize
                var page2 = db.Queryable<Student>().Where(c => c.id > 10).OrderBy(it => it.id).ToPageList(2, 10);

                //查询条数
                var count = db.Queryable<Student>().Where(c => c.id > 10).Count();

                //从第2条开始以后取所有
                var skip = db.Queryable<Student>().Where(c => c.id > 10).OrderBy(it => it.id).Skip(2).ToList();

                //取前2条
                var take = db.Queryable<Student>().Where(c => c.id > 10).OrderBy(it => it.id).Take(2).ToList();

                // Not like 
                string conval = "a";
                var notLike = db.Queryable<Student>().Where(c => !c.name.Contains(conval.ToString())).ToList();
                //Like
                conval = "三";
                var like = db.Queryable<Student>().Where(c => c.name.Contains(conval)).ToList();

                //支持字符串Where 让你解决，更复杂的查询
                var student12 = db.Queryable<Student>().Where(c => "a" == "a").Where("id>@id", new { id = 1 }).ToList();
                var student13 = db.Queryable<Student>().Where(c => "a" == "a").Where("id>100 and id in( select 1)").ToList();


                //存在记录反回true，则否返回false
                bool isAny100 = db.Queryable<Student>().Any(c => c.id == 100);
                bool isAny1 = db.Queryable<Student>().Any(c => c.id == 1);


                //获取最大Id
                object maxId = db.Queryable<Student>().Max(it => it.id);
                int maxId1 = db.Queryable<Student>().Max(it => it.id).ObjToInt();//拉姆达
                int maxId2 = db.Queryable<Student>().Max<int>("id"); //字符串写法

                //获取最小
                int minId1 = db.Queryable<Student>().Where(c => c.id > 0).Min(it => it.id).ObjToInt();//拉姆达
                int minId2 = db.Queryable<Student>().Where(c => c.id > 0).Min<int>("id");//字符串写法


                //order By 
                var orderList = db.Queryable<Student>().OrderBy("id desc,name asc").ToList();//字符串支持多个排序
                //可以多个order by表达示
                var order2List = db.Queryable<Student>().OrderBy(it => it.name).OrderBy(it => it.id, OrderByType.desc).ToList(); // order by name as ,order by id desc

                //In
                var intArray = new[] { "5", "2", "3" };
                var intList = intArray.ToList();
                var listnew = db.Queryable<Student>().Where(it => intArray.Contains(it.name)).ToList();
                var list0 = db.Queryable<Student>().In(it => it.id, 1, 2, 3).ToList();
                var list1 = db.Queryable<Student>().In(it => it.id, intArray).ToList();
                var list2 = db.Queryable<Student>().In("id", intArray).ToList();
                var list3 = db.Queryable<Student>().In(it => it.id, intList).ToList();
                var list4 = db.Queryable<Student>().In("id", intList).ToList();

                //分组查询
                var list7 = db.Queryable<Student>().Where(c => c.id < 20).GroupBy(it => it.sex).Select("sex,count(*) Count").ToDynamic();
                var list8 = db.Queryable<Student>().Where(c => c.id < 20).GroupBy(it => it.sex).GroupBy(it => it.id).Select("id,sex,count(*) Count").ToDynamic();
                List<StudentGroup> list9 = db.Queryable<Student>().Where(c => c.id < 20).GroupBy(it => it.sex).Select<StudentGroup>("Sex,count(*) Count").ToList();
                List<StudentGroup> list10 = db.Queryable<Student>().Where(c => c.id < 20).GroupBy("sex").Select<StudentGroup>("Sex,count(*) Count").ToList();
                //SELECT Sex,Count=count(*)  FROM Student  WHERE 1=1  AND  (id < 20)    GROUP BY Sex --生成结果



                //2表关联查询
                var jList = db.Queryable<Student>()
                .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) //默认left join
                .Where<School>((s1, s2) => s1.id == 1)
                .Select("s1.*,s2.name as schName")
                .ToDynamic();

                /*等于同于
                 SELECT s1.*,s2.name as schName 
                 FROM [Student]  s1 
                 LEFT JOIN [School]  s2 ON  s1.sch_id  = s2.id 
                 WHERE  s1.id  = 1 */

                //2表关联查询并分页
                var jList2 = db.Queryable<Student>()
                .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) //默认left join
                    //如果要用inner join这么写
                    //.JoinTable<School>((s1, s2) => s1.sch_id == s2.id ,JoinType.INNER)
                .Where<School>((s1, s2) => s1.id > 1)
                .OrderBy(s1 => s1.name)
                .Skip(10)
                .Take(20)
                .Select("s1.*,s2.name as schName")
                .ToDynamic();

                //3表查询并分页
                var jList3 = db.Queryable<Student>()
               .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) // left join  School s2  on s1.id=s2.id
               .JoinTable<School>((s1, s3) => s1.sch_id == s3.id) // left join  School s3  on s1.id=s3.id
               .Where<School>((s1, s2) => s1.id > 1)  // where s1.id>1
               .Where(s1 => s1.id > 0)
               .OrderBy<School>((s1, s2) => s1.id) //order by s1.id 多个order可以  .oderBy().orderby 叠加 
               .Skip(10)
               .Take(20)
               .Select("s1.*,s2.name as schName,s3.name as schName2")//select目前只支持这种写法
               .ToDynamic();


                //上面的方式都是与第一张表join，第三张表想与第二张表join写法如下
                List<V_Student> jList4 =
                 db.Queryable<Student>()
                 .JoinTable<School>((s1, s2) => s1.sch_id == s2.id) // left join  School s2  on s1.id=s2.id
                 .JoinTable<School, Area>((s1, s2, a1) => a1.id == s2.AreaId)// left join  Area a1  on a1.id=s2.AreaId  第三张表与第二张表关联
                 .JoinTable<Area, School>((s1, a1, s3) => a1.id == s3.AreaId)// left join  School s3  on a1.id=s3.AreaId  第四第表第三张表关联
                 .JoinTable<School>((s1, s4) => s1.sch_id == s4.id) // left join  School s2  on s1.id=s4.id
                 .Select<School, Area, V_Student>((s1, s2, a1) => new V_Student { id = s1.id, name = s1.name, SchoolName = s2.name, AreaName = a1.name }).ToList();

                //等同于
                //SELECT id = s1.id, name = s1.name, SchoolName = s2.name, AreaName = a1.name  
                //FROM [Student]   s1 
                //LEFT JOIN School  s2 ON  ( s1.sch_id  = s2.id )    
                //LEFT JOIN Area  a1 ON  ( a1.id  = s2.AreaId )     //第三张表与第二张表关联
                //LEFT JOIN School  s3 ON  ( a1.id  = s3.AreaId )   //第四张表与第三张表关联
                //LEFT JOIN School  s4 ON  ( s1.sch_id  = s4.id )    
                //WHERE 1=1    


                //Join子查询语句加分页的写法
                var childQuery = db.Queryable<Area>().Where("id=@id").Select(it => new { id = it.id }).ToSql();//创建子查询SQL
                string childTableName = string.Format("({0})", childQuery.Key);//将SQL语句用()包成表
                var queryable = db.Queryable<Student>()
                 .JoinTable<School>((s1, s2) => s1.sch_id == s2.id)  //LEFT JOIN School  s2 ON  ( s1.sch_id  = s2.id )  
                 .JoinTable(childTableName, "a1", "a1.id=s2.areaid", new { id = 1 }, JoinType.INNER) //INNER JOIN (SELECT *  FROM [Area]   WHERE 1=1  AND id=@id   ) a1 ON a1.id=s2.areaid
                 .OrderBy(s1 => s1.id);

                var list = queryable.Select<School, Area, V_Student>((s1, s2, a1) => new V_Student { id = s1.id, name = s1.name, SchoolName = s2.name, AreaName = a1.name })
                    .ToPageList(0, 200);
                var count2 = list.Count;


                //拼接例子
                var queryable2 = db.Queryable<Student>().Where(it => true);
                if (maxId.ObjToInt() == 1)
                {
                    queryable2.Where(it => it.id == 1);
                }
                else
                {
                    queryable2.Where(it => it.id == 2);
                }
                var listJoin = queryable2.ToList();


                //queryable和SqlSugarClient解耦
                var par = new Queryable<Student>().Where(it => it.id == 1);//声名没有connection对象的Queryable
                par.DB = db;
                var listPar = par.ToList();


                //查看生成的sql和参数
                var id = 1;
                var sqlAndPars = db.Queryable<Student>().Where(it => it.id == id).OrderBy(it => it.id).ToSql();



                //条件函数的支持(字段暂不支持函数,只有参数支持) 目前只支持这么多
                var par1 = "2015-1-1"; var par2 = "   我 有空格A, ";
                var r1 = db.Queryable<Student>().Where(it => it.name == par1.ObjToString()).ToSql(); //ObjToString会将null转转成""
                var r2 = db.Queryable<InsertTest>().Where(it => it.d1 == par1.ObjToDate()).ToSql();
                var r3 = db.Queryable<InsertTest>().Where(it => it.id == 1.ObjToInt()).ToSql();//ObjToInt会将null转转成0
                var r4 = db.Queryable<InsertTest>().Where(it => it.id == 2.ObjToDecimal()).ToSql();
                var r5 = db.Queryable<InsertTest>().Where(it => it.id == 3.ObjToMoney()).ToSql();
                var r6 = db.Queryable<InsertTest>().Where(it => it.v1 == par2.Trim()).ToSql();
                var convert1 = db.Queryable<Student>().Where(c => c.name == "a".ToString()).ToList();
                var convert2 = db.Queryable<Student>().Where(c => c.id == Convert.ToInt32("1")).ToList();
                var convert3 = db.Queryable<Student>().Where(c => c.name == par2.ToLower()).ToList();
                var convert4 = db.Queryable<Student>().Where(c => c.name == par2.ToUpper()).ToList();
                var convert5= db.Queryable<Student>().Where(c => DateTime.Now > Convert.ToDateTime("2015-1-1")).ToList();
                var c1 = db.Queryable<Student>().Where(c => c.name.Contains("a")).ToList();
                var c2 = db.Queryable<Student>().Where(c => c.name.StartsWith("a")).ToList();
                var c3 = db.Queryable<Student>().Where(c => c.name.EndsWith("a")).ToList();
                var c4 = db.Queryable<Student>().Where(c => !string.IsNullOrEmpty(c.name)).ToList();

  }

2、SqlQuery 用于执行原生SQL和存储过程 / Execution of native SQL

 using (var db = SugarDao.GetInstance())
 {
                //转成list
                List<Student> list1 = db.SqlQuery<Student>("select * from Student");
                //转成list带参
                List<Student> list2 = db.SqlQuery<Student>("select * from Student where id=@id", new { id = 1 });
                //转成dynamic
                dynamic list3 = db.SqlQueryDynamic("select * from student");
                //转成json
                string list4 = db.SqlQueryJson("select * from student");
                //返回int
                var list5 = db.SqlQuery<int>("select top 1 id from Student").SingleOrDefault();
                //反回键值
                Dictionary<string, string> list6 = db.SqlQuery<KeyValuePair<string, string>>("select id,name from Student").ToDictionary(it => it.Key, it => it.Value);
                //反回List<string[]>
                var list7 = db.SqlQuery<string[]>("select top 1 id,name from Student").SingleOrDefault();
                //存储过程
                var spResult = db.SqlQuery<School>("exec sp_school @p1,@p2", new { p1 = 1, p2 = 2 });

                //存储过程加Output 
                var pars = SqlSugarTool.GetParameters(new { p1 = 1,p2=0 }); //将匿名对象转成SqlParameter
                db.IsClearParameters = false;//禁止清除参数
                pars[1].Direction = ParameterDirection.Output; //将p2设为 output
                var spResult2 = db.SqlQuery<School>("exec sp_school @p1,@p2 output", pars);
                db.IsClearParameters = true;//启动请动清除参数
                var outPutValue = pars[1].Value;//获取output @p2的值

                //获取第一行第一列的值
                string v1 = db.GetString("select '张三' as name");
                int v2 = db.GetInt("select 1 as name");
                double v3 = db.GetDouble("select 1 as name");
                decimal v4 = db.GetDecimal("select 1 as name");
                //....
            }

3、Sqlable 更贴近SQL的一种编程方式，适用于复杂查询 / Complex query

//---------Sqlable,创建多表查询---------//

                //多表查询
                List<School> dataList = db.Sqlable()
                   .From("school", "s")
                   .Join("student", "st", "st.id", "s.id", JoinType.INNER)
                   .Join("student", "st2", "st2.id", "st.id", JoinType.LEFT)
                   .Where("s.id>100 and s.id<@id")
                   .Where("1=1")//可以多个WHERE
                   .SelectToList<School/*新的Model我这里没有所以写的School*/>("st.*", new { id = 1 });

                //多表分页
                List<School> dataPageList = db.Sqlable()
                    .From("school", "s")
                    .Join("student", "st", "st.id", "s.id", JoinType.INNER)
                    .Join("student", "st2", "st2.id", "st.id", JoinType.LEFT)
                    .Where("s.id>100 and s.id<100")
                    .SelectToPageList<School>("st.*", "s.id", 1, 10);

                //多表分页WHERE加子查询
                List<School> dataPageList2 = db.Sqlable()
                    .From("school", "s")
                    .Join("student", "st", "st.id", "s.id", JoinType.INNER)
                    .Join("student", "st2", "st2.id", "st.id", JoinType.LEFT)
                    .Where("s.id>100 and s.id<100 and s.id in (select 1 )" /*这里面写子查询都可以*/)
                    .SelectToPageList<School>("st.*", "s.id", 1, 10);



                //--------转成List Dynmaic 或者 Json-----//

                //不分页
                var list1 = db.Sqlable().From("student", "s").Join("school", "l", "s.sch_id", "l.id and l.id=@id", JoinType.INNER).SelectToDynamic("*", new { id = 1 });
                var list2 = db.Sqlable().From("student", "s").Join("school", "l", "s.sch_id", "l.id and l.id=@id", JoinType.INNER).SelectToJson("*", new { id = 1 });
                var list3 = db.Sqlable().From("student", "s").Join("school", "l", "s.sch_id", "l.id and l.id=@id", JoinType.INNER).SelectToDataTable("*", new { id = 1 });

                //分页
                var list4 = db.Sqlable().From("student", "s").Join("school", "l", "s.sch_id", "l.id and l.id=@id", JoinType.INNER).SelectToPageDynamic("s.*", "l.id", 1, 10, new { id = 1 });
                var list5 = db.Sqlable().From("student", "s").Join("school", "l", "s.sch_id", "l.id and l.id=@id", JoinType.INNER).SelectToPageTable("s.*", "l.id", 1, 10, new { id = 1 });
                var list6 = db.Sqlable().From("student", "s").Join("school", "l", "s.sch_id", "l.id and l.id=@id", JoinType.INNER).SelectToPageDynamic("s.*", "l.id", 1, 10, new { id = 1 });


                //--------拼接-----//
                Sqlable sable = db.Sqlable().From<Student>("s").Join<School>("l", "s.sch_id", "l.id", JoinType.INNER);
                string name = "a";
                int id = 1;
                if (!string.IsNullOrEmpty(name))
                {
                    sable = sable.Where("s.name=@name");
                }
                if (!string.IsNullOrEmpty(name))
                {
                    sable = sable.Where("s.id=@id or s.id=100");
                }
                if (id > 0)
                {
                    sable = sable.Where("l.id in (select top 10 id from school)");//where加子查询
                }
                var pars = new { id = id, name = name };
                int pageCount = sable.Count(pars);
                var list7 = sable.SelectToPageList<Student>("s.*","l.id desc",1,20, pars);

多表查询

4、新容器转换 / To new container

 using (SqlSugarClient db = SugarDao.GetInstance())
            {

                //单表操作将Student转换成V_Student
                var queryable = db.Queryable<Student>().Where(c => c.id < 10)
                    .Select<V_Student>(c => new V_Student { id = c.id, name = c.name, AreaName = "默认地区", SchoolName = "默认学校", SubjectName = "NET" });

                var list = queryable.ToList();
                var json = queryable.ToJson();
                var dynamic = queryable.ToDynamic();


                //多表操作将Student转换成V_Student
                var queryable2 = db.Queryable<Student>()
                 .JoinTable<School>((s1, s2) => s1.sch_id == s2.id)
                 .Where<School>((s1, s2) => s2.id < 10)
                 .Select<School, V_Student>((s1, s2) => new V_Student() { id = s1.id, name = s1.name, AreaName = "默认地区", SchoolName = s2.name, SubjectName = "NET" });//select new 目前只支持这种写法

                var list2 = queryable2.ToList();
                var json2 = queryable2.ToJson();
                var dynamic2 = queryable2.ToDynamic();


                //select字符串 转换成V_Student
                var list3 = db.Queryable<Student>()
               .JoinTable<School>((s1, s2) => s1.sch_id == s2.id)
               .Where(s1 => s1.id <= 3)
               .Select<V_Student>("s1.*,s2.name SchoolName")
               .ToList();

                //select字符串 转换成Json
                var json3 = db.Queryable<Student>()
               .JoinTable<School>((s1, s2) => s1.sch_id == s2.id)
               .Where(s1 => s1.id <= 3)
               .Select<V_Student>("s1.*,s2.name SchoolName")
               .ToJson();

                //select字符串 转换成Json
                var dynamic3 = db.Queryable<Student>()
               .JoinTable<School>((s1, s2) => s1.sch_id == s2.id)
               .Where(s1 => s1.id <= 3)
               .Select<V_Student>("s1.*,s2.name SchoolName")
               .ToDynamic();


                //新容器转换函数的支持 只支持ObjToXXX和Convert.ToXXX
                var f1 = db.Queryable<InsertTest>().Select<Student>(it => new Student()
                {
                    name = it.d1.ObjToString(),
                    id = it.int1.ObjToInt() // 支持ObjToXXX 所有函数

                }).ToList();

                var f2 = db.Queryable<InsertTest>().Select<Student>(it => new Student()
                {
                    name = Convert.ToString(it.d1),//支持Convet.ToXX所有函数
                    id = it.int1.ObjToInt(),
                    sex = Convert.ToString(it.d1),

                }).ToList();

                var f3 = db.Queryable<InsertTest>()
                    .JoinTable<InsertTest>((i1, i2) => i1.id == i2.id)
                    .Select<InsertTest, Student>((i1, i2) => new Student()
                    {
                        name = Convert.ToString(i1.d1), //多表查询例子
                        id = i1.int1.ObjToInt(),
                        sex = Convert.ToString(i2.d1),

                    }).ToList();


                //Select 外部参数用法
                var f4 = db.Queryable<InsertTest>().Where("1=1", new { id = 100 }).Select<Student>(it => new Student()
                {
                    id = "@id".ObjToInt(), //取的是 100 的值
                    name = "张三",//内部参数可以直接写
                    sex = it.txt,
                    sch_id = it.id

                }).ToList();
                var f6 = db.Queryable<InsertTest>()
               .JoinTable<InsertTest>((i1, i2) => i1.id == i2.id)
               .Where("1=1", new { id = 100, name = "张三", isOk = true }) //外部传参给@id
               .Select<InsertTest, Student>((i1, i2) => new Student()
               {
                   name = "@name".ObjToString(), //多表查询例子
                   id = "@id".ObjToInt(),
                   sex = i2.txt,
                   sch_id = 1,
                   isOk = "@isOk".ObjToBool()

               }).ToList();
            }

添加/Add

 using (SqlSugarClient db = SugarDao.GetInstance())//开启数据库连接
            {
                Student s = new Student()
                {
                    name = "张" + new Random().Next(1, int.MaxValue)
                };

                db.Insert(s); //插入一条记录 (有主键也好，没主键也好，有自增列也好都可以插进去)


                List<Student> list = new List<Student>()
                {
                     new Student()
                {
                     name="张"+new Random().Next(1,int.MaxValue)
                },
                 new Student()
                {
                     name="张"+new Random().Next(1,int.MaxValue)
                }
                };

                db.InsertRange(list); //批量插入
            }
        }

添加

新功能SqlSugar 2.7 高性能批量插入，

using (SqlSugarClient db = SugarDao.GetInstance())//开启数据库连接
            {
                var list = new List<Student>()
                {
                    new Student(){ isOk=true, name="张三",  sch_id=1, sex="男"},
                    new Student(){ isOk=true, name="sun",  sch_id=1, sex="女"},
                    new Student(){ isOk=true, name="mama",  sch_id=1, sex="gril"}
                };
                db.SqlBulkCopy<Student>(list);
            }

2.8.01设置不插入列

                //设置不插入
                db.DisableInsertColumns = new string[] { "sex" };//设置sex不插入
                
                Student s2 = new Student()
                {
                    name = "张" + new Random().Next(1, int.MaxValue)    
                };

                db.Insert(s); //插入一

更新/Update

 using (var db = SugarDao.GetInstance())
            {
                //指定列更新
                db.Update<School>(new { name = "蓝翔2" }, it => it.id == id);
                db.Update<School, int>(new { name = "蓝翔2" }, 1, 3, 12);
                db.Update<School, string>(new { name = "蓝翔2" }, new string[] { "1", "2" });

                //整个实体更新
                db.Update(new School { id = id, name = "蓝翔2" });
                db.Update<School>(new School { id = id, name = "蓝翔2" }, it => it.id == id);


                //设置不更新列
                db.DisableUpdateColumns = new string[] { "CreateTime" };//设置CreateTime不更新

                TestUpdateColumns updObj = new TestUpdateColumns()
                {
                    VGUID = Guid.Parse("542b5a27-6984-47c7-a8ee-359e483c8470"),
                    Name = "xx",
                    Name2 = "xx2",
                    IdentityField = 0,
                    CreateTime = null
                };

                //CreateTime将不会被更新
                db.Update(updObj);
                //以前实现这种更新需要用指定列的方式实现，现在就简单多了。
               
            }

更新

删除和假删除/Delete And False Delete

                //删除
                db.Delete<School, int>(10);//注意主键必需为实体类的第一个属性
                db.Delete<School>(it => it.id > 100);
                //主键批量删除
                db.Delete<School, string>(new string[] { "100", "101", "102" });
                //非主键批量删除
                db.Delete<School, string>(it => it.name, new string[] { "" });
                db.Delete<School, int>(it => it.id, new int[] { 20, 22 });

                //假删除
                //db.FalseDelete<school>("is_del", 100);
                //等同于 update school set is_del=1 where id in(100)
                //db.FalseDelete<school>("is_del", it=>it.id==100);

View Code

全局过滤器/ Gobal Filter

这功能主要用于通用权限设计等功能，当有很多WHERE重复，并且动态这时候就需要在全局设置好过滤器接口集合，程序中使用只需要设KEY便可

    /// <summary>
    /// 过滤器
    /// </summary>
    public partial class Filter : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            using (SqlSugarClient db = SugarDaoFilter.GetInstance())//开启数据库连接
            {
                //设置走哪个过滤器
                db.CurrentFilterKey = "role";

                //queryable
                var list = db.Queryable<Student>().ToList(); //通过全局过滤器对需要权限验证的数据进行过滤
                //相当于db.Queryable<Student>().Where("id=@id",new{id=1})


                //sqlable
                var list2 = db.Sqlable().Form<Student>("s").SelectToList<Student>("*");
                //同上

                //sqlQuery
                var list3 = db.SqlQuery<Student>("select * from Student");
                //同上
            }
        }
    }
    /// <summary>
    /// 扩展SqlSugarClient
    /// </summary>
    public class SugarDaoFilter
    {
        //禁止实例化
        private SugarDaoFilter()
        {

        }
        /// <summary>
        /// 页面所需要的过滤函数
        /// </summary>
        private static Dictionary<string, Func<KeyValueObj>> _filterParas = new Dictionary<string, Func<KeyValueObj>>()
        {
          { "role",()=>{
                    return new KeyValueObj(){ Key=" id=@id" , Value=new{ id=1}};
               }
          },
          { "org",()=>{ 
                    return new KeyValueObj(){ Key=" orgId=@orgId" , Value=new{ orgId=1}};
              }
          },
        };
        public static SqlSugarClient GetInstance()
        {
            string connection = System.Configuration.ConfigurationManager.ConnectionStrings[@"sqlConn"].ToString(); //这里可以动态根据cookies或session实现多库切换
            var reval = new SqlSugarClient(connection);
            reval.SetFilterFilterParas(_filterParas);
            return reval;
        }
    }

过滤器

行列同时过滤 2.7.07

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using SqlSugar;
using Models;

namespace WebTest.Demos
{/// <summary>
    /// 过滤器 (查询行过滤加查询列过滤)
    /// </summary>
    public partial class Filter2 : System.Web.UI.Page
    {

        protected void Page_Load(object sender, EventArgs e)
        {
            using (SqlSugarClient db = SugarDaoFilter.GetInstance())//开启数据库连接
            {
                //设置走哪个过滤器
                db.CurrentFilterKey = "role";


                //queryable
                var list = db.Queryable<Student>().ToJson();


                //设置走哪个过滤器
                db.CurrentFilterKey = "org";


                //queryable
                var list2 = db.Queryable<Student>().ToJson();

            }
        }
    }
    /// <summary>
    /// 扩展SqlSugarClient
    /// </summary>
    public class SugarDaoFilter
    {
        //禁止实例化
        private SugarDaoFilter()
        {

        }
        /// <summary>
        /// 页面所需要的过滤行
        /// </summary>
        private static Dictionary<string, Func<KeyValueObj>> _filterParas = new Dictionary<string, Func<KeyValueObj>>()
            {
              { "role",()=>{
                        return new KeyValueObj(){ Key=" id=@id" , Value=new{ id=1}};
                   }
              },
              { "org",()=>{
                  return new KeyValueObj() { Key = " id=@id", Value = new { id = 2 } };
                  }
              },
            };
        /// <summary>
        /// 页面所需要的过滤列
        /// </summary>
        private static Dictionary<string, List<string>> _filterColumns = new Dictionary<string, List<string>>()
            {
              { "role",new List<string>(){"id","name"}
              },
              { "org",new List<string>(){"name"}
              },
            };
        public static SqlSugarClient GetInstance()
        {
            string connection = System.Configuration.ConfigurationManager.ConnectionStrings[@"sqlConn"].ToString(); //这里可以动态根据cookies或session实现多库切换
            var reval = new SqlSugarClient(connection);

            //支持sqlable和queryable
            reval.SetFilterFilterParas(_filterParas);

            //列过滤只支持queryable
            reval.SetFilterFilterParas(_filterColumns);
            return reval;
        }
    }

}

行列过滤

无参模式/No Parameter

将IsGetPageParas设为true之后页面的参数都不需要使用 new{}来赋值

         using (SqlSugarClient db = SugarDao.GetInstance())//开启数据库连接
                {

                    db.IsGetPageParas = true;//使用无参模式直接将Requst中的ID传给@id无需在代码中写出来

                    var list = db.Queryable<Student>().Where("id=@id").ToList();

                    //sqlable queryable sqlquery通用

                    //获取页面所有参数到键值对
                    //var kvs= SqlSugarTool.GetParameterDictionary();

                    //以前写法
                    //var xx = db.Queryable<Student>().Where("id=@id", new { id=Request["id"] }).ToList();
                }

无参

事务 /Transaction

 using (SqlSugarClient db = SugarDao.GetInstance())//开启数据库连接
            {
                db.IsNoLock = true;//启用无锁查询
                db.CommandTimeOut = 30000;//设置超时时间
                try
                {
                    db.BeginTran();//开启事务

                    db.CommitTran();//提交事务
                }
                catch (Exception)
                {
                    db.RollbackTran();//回滚事务
                    throw;
                }
            }

事务

公开函数 /Common Method

 //ToJoinSqlInVal
            var par = new string[] { "a", "c", "3" };
            var ids = par.ToJoinSqlInVal();//将数组转成 'a','c','3'  有防SQL注入处理


            //ToSqlValue
            try
            {
                var par2 = "a'";
                var newpar2 = par2.ToSqlValue();//对字符串防注入处理
            }
            catch (Exception ex)
            {

                Response.Write(ex.Message);
            }

            //SqlLikeWordEncode 处理LIKE特殊字符
            var likestr = SqlSugarTool.SqlLikeWordEncode("[%%%");


            //GetParameterArray 获取页面参数所有参数的键和值
            var pars = SqlSugarTool.GetParameterArray();


            //将匿名对象转成SqlParameter
            var par3= SqlSugarTool.GetParameters(new { id=1});

函数

实体生成 /Create Entity File

 using (var db = SugarDao.GetInstance())
            {
                //可以结合别名表，请看别名表的用法
                //db.SetMappingTables(mappingTableList);

                db.ClassGenerating.CreateClassFiles(db, ("e:/TestModels"), "Models");


                //批量设置别名表,可以方便生成指定格式的实体对象
                db.ClassGenerating.ForeachTables(db, tableName =>
                {
                    db.AddMappingTable(new KeyValue() { Key = "Rename_"+tableName, Value =  tableName });
                });

                //生成的文件都Rename_开头
                db.ClassGenerating.CreateClassFiles(db, ("e:/TestModels"), "Models",
                    null, 
                    className => { 
                      //生成文件之后的回调
                    }, tableName => {
                      //生成文件之前的回调
                    });


                //只生成student和school表的实体
                db.ClassGenerating.CreateClassFilesByTableNames(db, "e:/TestModels2", "Models", new string[] { "student", "school" });

                //根据表名生成class字符串
                var str = db.ClassGenerating.TableNameToClass(db, "Student");

                var dynamicToClassStr = db.ClassGenerating.DynamicToClass(new { id = 1 }, "dyName");

                //根据SQL语句生成class字符串
                var str2 = db.ClassGenerating.SqlToClass(db, "select top 1 * from Student", "student");

                //改变值（lassTemplate.ItemTemplate=XXXX）可以自定义格式
                var tempItem = ClassTemplate.ItemTemplate;//例如可以在生成的实体添加默认构造函数给指定的字段赋默认值或者公司信息等
                var temp = ClassTemplate.Template;
                var temSummary = ClassTemplate.ClassFieldSummaryTemplate;


                //设置新格式模板
                //主键Guid.New(),
                //CreateTime为DateTime.Now 
                //IsRemove=0
                //UpdateTime为DateTime.Now 
                ClassTemplate.Template = "using System;
using System.Linq;
using System.Text;

namespace $namespace
{
    public class $className
    {
        public $className() 
        { 
            this.CreateTime = DateTime.Now;
            this.  = 0;
            this.UpdateTime=DateTime.Now;
            this.$primaryKeyName=Guid.NewGuid().ToString("N").ToUpper();
        }
        $foreach
    }
}
";

                //新格式的实体字符串
                var str3 = db.ClassGenerating.TableNameToClass(db, "Student");

            }

View Code

T4模版

详细教程：

http://www.cnblogs.com/sunkaixuan/p/5751503.html

自定义生成实体的格式

例如给每个实体指定字段添加默认值

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using WebTest.Dao;
using SqlSugar;

namespace WebTest.Demos
{
    public partial class CreateModelFile2 : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            //自定义实体模板引擎模块
            ClassTemplate.Template = "using System;
using System.Linq;
using System.Text;

namespace $namespace
{
    public class $className
    {
        public $className() 
        { 
            this.CreateTime = DateTime.Now;
            this.IsRemove = 0;
            this.UpdateTime=DateTime.Now;
            this.$primaryKeyName=Guid.NewGuid().ToString("N").ToUpper();
        }
        $foreach
    }
}
";
            using (var db = SugarDao.GetInstance())
            {
                db.ClassGenerating.CreateClassFiles(db, "e:/TestModel", "Models");
                //生成的Model带构造函数并且赋了默认值 ，如下注释

            }
        }
        //public class InsertTest
        //{
        //    public InsertTest()
        //    {
        //        this.CreateTime = DateTime.Now;
        //        this.IsRemove = 0;
        //        this.UpdateTime = DateTime.Now;
        //        this.id = Guid.NewGuid().ToString("N").ToUpper();
        //    }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:False 
        //    /// </summary>
        //    public int id { get; set; }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:True 
        //    /// </summary>
        //    public string v1 { get; set; }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:True 
        //    /// </summary>
        //    public string v2 { get; set; }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:True 
        //    /// </summary>
        //    public string v3 { get; set; }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:True 
        //    /// </summary>
        //    public int? int1 { get; set; }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:True 
        //    /// </summary>
        //    public DateTime? d1 { get; set; }

        //    /// <summary>
        //    /// Desc:- 
        //    /// Default:- 
        //    /// Nullable:True 
        //    /// </summary>
        //    public string txt { get; set; }

        //}
    }
}

View Code

别名表/Rename table name

SqlSugar走的是POCO路线，并不需要在Model里面添加任何特性

    /// <summary>
    /// 使用别名表功能
    /// </summary>
    public partial class Rename : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            using (SqlSugarClient db = SugarFactory.GetInstance())
            {
                var list = db.Queryable<V_Student>().ToList(); //使用别名表
            }
        }
    }
    /// <summary>
    /// 全局配置类
    /// </summary>
    public class SugarConfigs
    {
        //key类名 value表名
        public static List<KeyValue> MpList = new List<KeyValue>(){
                new KeyValue(){ Key="FormAttr", Value="Flow_FormAttr"},
                new KeyValue(){ Key="Student3", Value="Student"},
                new KeyValue(){ Key="V_Student", Value="Student"}
                };
    }
    /// <summary>
    /// SqlSugar实例工厂
    /// </summary>
    public class SugarFactory
    {

        //禁止实例化
        private SugarFactory()
        {

        }
        public static SqlSugarClient GetInstance()
        {
            string connection = System.Configuration.ConfigurationManager.ConnectionStrings[@"sqlConn"].ToString(); //这里可以动态根据cookies或session实现多库切换
            var db = new SqlSugarClient(connection);
            db.SetMappingTables(SugarConfigs.MpList);//设置关联表 (引用地址赋值，每次赋值都只是存储一个内存地址)
            return db;
        }
    }

枚举支持

        protected void Page_Load(object sender, EventArgs e)
        {
            using (SqlSugarClient db = SugarDao.GetInstance())
            {
                var stuList= db.Queryable<Student>().ToList();
                db.Insert<Student>(new Student() { sch_id = SchoolEnum.北大青鸟 });
                db.Update<Student>(new Student() { sch_id = SchoolEnum.it清华, id = 11 });
                var stuList2 = db.Queryable<Student>().Where(it => it.sch_id == SchoolEnum.全智).ToList();
            }
        }


        public class Student
        {

            /// <summary>
            /// 说明:- 
            /// 默认:- 
            /// 可空:False 
            /// </summary>
              public int id { get; set; }

            /// <summary>
            /// 说明:- 
            /// 默认:- 
            /// 可空:True 
            /// </summary>
            public string name { get; set; }

            /// <summary>
            /// 说明:- 
            /// 默认:- 
            /// 可空:False 
            /// </summary>
            public SchoolEnum sch_id { get; set; }

            /// <summary>
            /// 说明:- 
            /// 默认:- 
            /// 可空:True 
            /// </summary>
            public string sex { get; set; }

            /// <summary>
            /// 说明:- 
            /// 默认:- 
            /// 可空:False 
            /// </summary>
            public bool isOk { get; set; }

        }

        public enum SchoolEnum
        {
            北大青鸟 = 1,
            it清华 = 2,
            全智=3
        }

View Code

排除非数据库列 SqlSugar2.7新功能

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using SqlSugar;
using WebTest.Dao;
using WebTest.TestLib;

namespace WebTest.Demos
{
    public partial class IgnoreErrorColumns : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            using (SqlSugarClient db = SugarDao.GetInstance())
            {
       
                //设置别名表具体例子看rename.aspx，不是该例子的重点
                db.SetMappingTables(new List<KeyValue>() { new KeyValue() { Key = "MyStudent", Value = "Student" }, });
                 
                //重点来了
                //数据库并没有appendField和appendField2二个字段，设置该属性后将插入可以正常使用
                db.IsIgnoreErrorColumns = true;//自动排除非数据库列  update也一样
          
                db.Insert<MyStudent>(new MyStudent() { name = "张三" });
                //将实体MyStudent插入Student表
            }
        }
    }
    /// <summary>
    /// 继承了学生表
    /// </summary>
    public class MyStudent : Student
    {
        /// <summary>
        /// 这两个字段Student表并不存在
        /// </summary>
        public string appendField { get; set; }
        public string appendField2 { get; set; }
    }
}

智能提示配置

http://www.cnblogs.com/sunkaixuan/p/5851425.html

多库并行计算功能

 using (CloudClient db = CloudDao.GetInstance())
            {
                db.PageMaxHandleNumber = 1500;
                using (CommittableTransaction trans = new CommittableTransaction())//启用分布式事务
                {


                    db.Tran = trans;

                    /*** 增、删、改 ***/

                    //根据配置的百分比，随机插入到某个节点库
                    var s = new student()
                    {
                        createTime = DateTime.Now,
                        id = Guid.NewGuid(),
                        name = Guid.NewGuid() + ""
                    };
                    //db.Insert<student>(s, false/*false表示不是自增列*/); //数据库设计主键为GUID为佳多库计算不会冲突



                    ////并发请求所有节点找出这条数据更新
                    //s.name = "改11";
                    //db.Update<student>(s, it => it.id == s.id);//根据表达示更新


                    //db.Update<student, Guid>(s, s.id);//根据主键更新

                    //db.Update<student, Guid>(s, new Guid[] { s.id });//根据主键数组更新



                    ////并发请求所有节点找出这条数据删除
                    //db.Delete<student>(it => it.id == s.id);


                    trans.Commit();
                }

                db.TranDispose();


                /*** 使用Taskable实现云计算 ***/


                //多线程请求所有数据库节点，获取汇总结果
                var taskDataTable = db.Taskable<DataTable>("SELECT max(NUM) FROM STUDENT").Tasks;
                foreach (var dr in taskDataTable)//遍历所有节点数据
                {
                    var dt = dr.Result.DataTable;//每个节点的数据 类型为DataTable
                    var connectionName = dr.Result.ConnectionString;
                }

                //多线程请求所有数据库节点，获取汇总结果
                var taskInt = db.Taskable<int>("SELECT max(NUM) FROM STUDENT").Tasks;
                foreach (var dr in taskInt)//遍历所有节点数据
                {
                    var dt = dr.Result.Value;//获取单个值
                    var connectionName = dr.Result.ConnectionString;
                }

                //多线程请求所有数据库节点，获取汇总结果
                var taskEntity = db.Taskable<student>("SELECT top 100 * FROM STUDENT").Tasks;
                foreach (var dr in taskEntity)//遍历所有节点数据
                {
                    var dt = dr.Result.Entities;//获取实体集合
                    var connectionName = dr.Result.ConnectionString;
                }

                // //Taskable实现分组查询
                // var groupList = db.Taskable<DataTable>("SELECT name,COUNT(*) AS [count],AVG(num) as num FROM STUDENT WHERE ID IS NOT NULL  GROUP BY NAME ")
                //     .Tasks
                //     .SelectMany(it => it.Result.DataTable.AsEnumerable())
                //     .Select(dr => new { num = Convert.ToInt32(dr["NUM"]), name = dr["NAME"].ToString(), count = Convert.ToInt32(dr["COUNT"]) })
                //     .GroupBy(dr => dr.name).Select(dt => new { name = dt.First().name, count = dt.Sum(dtItem => dtItem.count), num = dt.Sum(dtItem => dtItem.num) / dt.Sum(dtItem => dtItem.count) }).ToList();


                // //输出结果
                // foreach (var it in groupList)
                // {
                //     var num = it.num;
                //     var name = it.name;
                //     var count = it.count;
                // }


                // //简化
                // var groupList2 = db.Taskable<DataTable>("SELECT NAME,COUNT(*) AS [COUNT],AVG(NUM) as NUM FROM STUDENT WHERE ID IS NOT NULL  GROUP BY NAME ")
                //.MergeTable()//将结果集合并到一个集合
                //.Select(dr => new { num = Convert.ToInt32(dr["NUM"]), name = dr["NAME"].ToString(), count = Convert.ToInt32(dr["COUNT"]) })
                //.GroupBy(dr => dr.name).Select(dt => new { name = dt.First().name, count = dt.Sum(dtItem => dtItem.count), num = dt.Sum(dtItem => dtItem.num) / dt.Sum(dtItem => dtItem.count) }).ToList();

                // //再简化
                // List<V_Student> groupList3 = db.Taskable<V_Student>("SELECT name,COUNT(*) AS [count],AVG(num) as num FROM STUDENT WHERE ID IS NOT NULL  GROUP BY NAME ")
                //.MergeEntities()//将结果集合并到一个集合
                //.GroupBy(dr => dr.name).Select(dt => new V_Student { name = dt.First().name, count = dt.Sum(dtItem => dtItem.count), num = dt.Sum(dtItem => dtItem.num) / dt.Sum(dtItem => dtItem.count) }).ToList();



                //更多简化函数
                int maxValue = db.Taskable<int>("SELECT max(NUM) FROM STUDENT").Max();//求出所有节点的最大值
                int minValue = db.Taskable<int>("SELECT min(NUM) FROM STUDENT").Min();//求出所有节点的最小值
                var dataCount = db.Taskable<int>("SELECT count(1) FROM STUDENT").Count();//求出所有节点数据
                // var avg = db.TaskableWithCount<int>("SELECT avg(num)", " FROM STUDENT").Avg();
                var all = db.Taskable<student>("select * from student where Contains(name,@name)"/*使用contains需要建全文索引*/, new { name = "张三" }).ToList();//获取所有节点name为张三的数据,转为list

                var dnSingle = DateTime.Now;
                var data = db.Taskable<student>("select * from student where id=@id", new { id = id }).ToSingle();//从所有节点中查询一条记录
                var timeSingle = (DateTime.Now - dnSingle).TotalSeconds;

                var dn = DateTime.Now;
                //单列排序
                //  var list = db.TaskableWithPage<student>("id", "select * from student    "/*使用contains需要建全文索引*/, 2160, 25, ref pageCount, "num", OrderByType.desc, new { name = ""*李*"" });
                var time = (DateTime.Now - dn).TotalSeconds;

                //多组排序 order by num,time
                var dn2 = DateTime.Now;
                var listMultipleOrderBy = db.TaskableWithPage<student>("id", "select * from student   "/*使用contains需要建全文索引*/, 5000, 25, ref pageCount, new List<OrderByDictionary>() { 
                     new   OrderByDictionary(){ OrderByField="num", OrderByType=OrderByType.asc},
                     //       new   OrderByDictionary(){ OrderByField="createTime", OrderByType=OrderByType.desc},
                   //  new OrderByDictionary(){ OrderByField="createTime", OrderByType=OrderByType.asc}
                }, new { name = ""*小*"" });
                var time2 = (DateTime.Now - dn2).TotalSeconds;


            }

多库模式

 /// <summary>
        /// 测试类
        /// </summary>
        public class student
        {
            public Guid id { get; set; }
            public string name { get; set; }
            public DateTime createTime { get; set; }
            public int num { get; set; }
        }
        /// <summary>
        /// 获取数据库连接对象
        /// </summary>
        public class CloudDao
        {
            private CloudDao() { }
            public static CloudClient GetInstance()
            {
                return new CloudClient(new List<CloudConnectionConfig>() { 
                 new CloudConnectionConfig(){  ConnectionString=ConfigurationManager.ConnectionStrings["c1"].ToString(), Rate=1},
                 new CloudConnectionConfig(){  ConnectionString=ConfigurationManager.ConnectionStrings["c2"].ToString(), Rate=1},
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c3"].ToString(), Rate=1},
                 new CloudConnectionConfig(){  ConnectionString=ConfigurationManager.ConnectionStrings["c4"].ToString(), Rate=1},
                 new CloudConnectionConfig(){  ConnectionString=ConfigurationManager.ConnectionStrings["c5"].ToString(), Rate=1},
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c6"].ToString(), Rate=1},
                 new CloudConnectionConfig(){  ConnectionString=ConfigurationManager.ConnectionStrings["c7"].ToString(), Rate=1},
                 new CloudConnectionConfig(){  ConnectionString=ConfigurationManager.ConnectionStrings["c8"].ToString(), Rate=1},
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c9"].ToString(), Rate=1},
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c10"].ToString(), Rate=1},
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c15"].ToString(), Rate=1},
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c16"].ToString(), Rate=1},              
                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["c17"].ToString(), Rate=1},
                //new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["cy1"].ToString(), Rate=1},
                //   new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["cy2"].ToString(), Rate=1},
                //    new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["cy3"].ToString(), Rate=1},
                //                      new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["zq1"].ToString(), Rate=1},
                //   new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["zq2"].ToString(), Rate=1},
                //    new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["zq3"].ToString(), Rate=1},
                //            new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["qp1"].ToString(), Rate=1},
                //   new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["qp2"].ToString(), Rate=1},
                //    new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["qp3"].ToString(), Rate=1},
                //                 new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["wy1"].ToString(), Rate=1},
                //   new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["wy2"].ToString(), Rate=1},
                //    new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["wy3"].ToString(), Rate=1},
                //                                   new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["wwf1"].ToString(), Rate=1},
                //   new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["wwf2"].ToString(), Rate=1},
                //    new CloudConnectionConfig(){ ConnectionString=ConfigurationManager.ConnectionStrings["wwf3"].ToString(), Rate=1},


            });
            }
        }

多库配置

3、性能/Performance

GITHUB下载地址：

MSSQL .NET 4.0+

https://github.com/sunkaixuan/SqlSugar

MSSQL .NET Core 版本

https://github.com/sunkaixuan/ASP_NET_CORE_ORM_SqlSugar

Sqlite .net4.0+

https://github.com/sunkaixuan/SqliteSugar

MYSQL .NET 4.0+

http://www.cnblogs.com/sunkaixuan/p/5747259.html

ORACLE.NET 4.0+

https://github.com/sunkaixuan/OracleSugar

ORACLE CORE ,MYSQL CORE,SQLITE CORE 待开发

技术讨论群： 225982985

相关阅读:
谈谈对程序猿的管理
 OFMessageDecoder 分析
 [LeetCode-21]Construct Binary Tree from Preorder and Inorder Traversal
leetcode第一刷_Rotate Image
[二次开发]dede文章页面怎样显示作者的头像
 MapReduceTopK TreeMap
安卓3d引擎
 LeetCode::Sort List 具体分析
 杨帆之工作日志-2014.6.24
CF1109F Sasha and Algorithm of Silence's Sounds
原文地址：https://www.cnblogs.com/sunkaixuan/p/5654695.html

Asp.Net 高性能ORM框架 SqlSugar.ORM 2.8

3.0最新API：

1、前言/Preface

GitHub下载地址：

优点：

2、功能介绍/Product function introduction

查询/Search

4、新容器转换 / To new container

添加/Add

更新/Update

删除和假删除/Delete And False Delete

全局过滤器/ Gobal Filter

无参模式/No Parameter

事务 /Transaction

公开函数 /Common Method

实体生成 /Create Entity File

T4模版

自定义生成实体的格式

别名表/Rename table name

枚举支持

排除非数据库列 SqlSugar2.7新功能

智能提示配置

多库并行计算功能

3、性能/Performance