C#数据操作系列-15SqlSugar增删改查详解
0. 前⾔
继上⼀篇，以及上上篇，我们对SqlSugar有了⼀个⼤概的认识，但是这并不完美，因为那些都是理论知识，⽆法描述我们⼯程开发中实际情况。⽽这⼀篇，将带领⼩伙伴们⼀起试着写⼀个能在⼯程中使⽤的模板类。
1. 创建⼀个Client
SqlSugar在操作的时候需要⼀个Client，⽤来管理数据库连接，并操作数据库。所以我们写⼀个DbContext⽤来创建Client：
public class DefaultContext
{
public SqlSugarClient Client {get;}
public DefaultContext(string connectionString, DbType dbType)
{
Client =new SqlSugarClient(new ConnectionConfig
{
ConnectionString = connectionString,//"Data Source=./demo.db",
DbType = dbType,
IsAutoCloConnection =true,
若有所思的近义词>挖春笋InitKeyType = InitKeyType.Attribute
});
Client.CodeFirst.InitTables(typeof(Dept),typeof(Person),typeof(Employee));
Client.Aop.OnLogExecuting =(sql, paramters)=>
{
Console.WriteLine(sql);
};
}
public SimpleClient<T>CreateClient<T>()where T :class,new()
{
return Client.GetSimpleClient<T>();
}
}
SqlSugar 提供了⼀个SimpleClient，这⾥⾯有很多可以直接拿来⽤的⽅法，⽽且这个是⼀个泛型类。也就是说我们可以使⽤它对单个实体类进⾏操作，这在开发中很重要。
2. 插⼊数据
对于⼀个程序⽽⾔，数据就像是⾎液⼀样重要。对于ORM框架，插⼊是⼀切来源的基础。所以我们先来看看SqlSugar的插⼊是怎样的吧：
2.1 简单的插⼊模式
public bool Inrt(T inrtObj);
public bool InrtRange(T[] inrtObjs);
public bool InrtRange(List inrtObjs);
这是SqlSugar在SimpleClient⾥提供的两个默认插⼊⽅法，⼀个是插⼊单个实体对象，⼀个是插⼊⼀组对象。
默认情况下，SqlSugar插⼊并不会将主键返回给数据。如果后续操作需要当前数据的主键，则可以调⽤另外⼀个⽅法：
public int InrtReturnIdentity(T inrtObj);
通过这个⽅法可以获取⼀个默认的int类型主键值。
2.2 ⾼级玩法
SqlSugar还有⼀种插⼊模式，通过AsInrtable返回⼀个 IInrtable泛型接⼝：
public IInrtable<T>AsInrtable(T inrtObj);
public IInrtable<T>AsInrtable(T[] inrtObjs);
public IInrtable<T>AsInrtable(List<T> inrtObjs);
这种模式与SimpleClient的普通插⼊模式不同，它并不会直接执⾏插⼊动作，需要⼿动调⽤并执⾏插⼊动作：
int ExecuteCommand();
执⾏动作，然后返回受影响的⾏数。
bool ExecuteCommandIdentityIntoEntity();
执⾏动作，然后将主键插⼊实体对象，返回插⼊结果。执⾏完成后，主键数据保存到实体⽰例中。
long ExecuteReturnBigIdentity();
int ExecuteReturnIdentity();
执⾏动作，然后返回主键值，不会更新实体。
有⼀点值得特别注意：
所有会返回主键的插⼊都只针对单个数据，如果⼀次插⼊多个数据，并不会返回主键信息也⽆法将主键信息更新⼊实体中。
以上都是全列插⼊，SqlSugar还提供了只插⼊部分列和忽略某些列两种模式：
IInrtable InrtColumns(Expression<Func<T, object>> columns);// 满⾜条件的插⼊，其他列则不插⼊
IInrtable InrtColumns(params string[] columns);//插⼊指定列名
IInrtable IgnoreColumns(Expression<Func<T, object>> columns);// 忽略满⾜条件的列，插⼊其他列
IInrtable IgnoreColumns(params string[] columns);// 忽略这⼏个列
IInrtable IgnoreColumns(bool ignoreNullColumn, bool isOffIdentity = fal);//指定是否忽略Null列，并是否强制插⼊主键
3. 更新或插⼊
介绍完插⼊，那么来介绍⼀下更新。正所谓，没有更新数据就是⼀滩死⽔，有了更新数据才有了变化。所以，就让我们来看看如何优雅的更新数据吧：
3.1 简单模式
先来两个最简单的：
public bool Update(T updateObj);
public bool UpdateRange(T[] updateObjs);
public bool UpdateRange(List<T> updateObjs);
传⼊实体，直接更新到数据库中，需要注意的是这种更新模式只需要保证主键有值，且与之对应即可。
public bool Update(Expression<Func<T, T>> columns, Expression<Func<T,bool>> whereExpression);
这是另⼀种条件更新，会更新满⾜whereExpression的所有元素，更新⽰例：
personClient.Update(p=>new Person
{
Age =1
}, p=>p.Id ==1);
columns需要返回⼀个要更新的对象的属性列，也就是在columns中设置需要更新的内容。
3.2 ⾼级模式
同样，通过AsUpdateable开启⾼级模式：
public IUpdateable<T>AsUpdateable(T[] updateObjs);
public IUpdateable<T>AsUpdateable(T updateObj);
public IUpdateable<T>AsUpdateable(List<T> updateObjs);
然后可以针对这些今天更多的操作：
int ExecuteCommand();朴宝剑图片
返回命令执⾏影响的⾏数
bool ExecuteCommandHasChange();
返回是否有变化，也就是影响⾏数是否⼤于0。
只更新某些列：
IUpdateable SetColumns(Expression<Func<T, bool>> columns);
更新⽰例：
personClient.AsUpdateable(d).SetColumns(t=>t.Age ==2).ExecuteCommand();厦门老年大学
传⼊⼀个lambda表达式，使数据满⾜lambda表达式。要求lambda表达式只能⽤==来判断列是否等于某个值。
IUpdateable<T>SetColumns(Expression<Func<T, T>> columns);
IUpdateable<T>UpdateColumns(params string[] columns);
IUpdateable<T>UpdateColumns(Expression<Func<T,object>> columns);
传⼊要更新的实际列名。其中 object ⽤来接⼀个匿名对象，其中属性名字就是要更新的值。
不更新某些列
IUpdateable<T>IgnoreColumns(params string[] columns);// 忽略传⼊的列名
IUpdateable<T>IgnoreColumns(Expression<Func<T,object>> columns);// ⽤匿名对象表⽰要忽略的列名
IUpdateable<T>IgnoreColumns(bool ignoreAllNullColumns,bool isOffIdentity =fal,bool ignoreAllDefaultValue =fal);// 设置是否忽略Null列，是否强制更新主键，是否忽略所有默认值列
条件更新
IUpdateable<T>Where(Expression<Func<T,bool>> expression);
IUpdateable<T>Where(string fieldName,string conditionalType,object fieldValue);
IUpdateable<T>Where(string whereSql,object parameters =null);
IUpdateable<T>WhereColumns(Expression<Func<T,object>> columns);
IUpdateable<T>WhereColumns(string columnName);
IUpdateable<T>WhereColumns(string[] columnNames);
来，简单猜⼀猜这⼏个是什么意思呢？
可以说很简单明了的⼏种条件设置模式，lambda表⽰筛选更新数据，字段值判断条件更新。
其中 conditionType的值，推荐使⽤ ConditionalType枚举的值。
3.3 更新或插⼊
在实际开发中可能会遇到插⼊或更新是⾛的⼀个⽅法，所以我们就要寻找⼀个可以直接更新或插⼊的⽅法。SqlSugar为此提供了解决⽅案：
ISaveable Saveable(T saveObject) where T : class, new();
ISaveable Saveable(List saveObjects) where T : class, new();
元宵节是什么时候不过这个⽅法是在SugarClient⾥，我们可以通过：
public ISqlSugarClient AsSugarClient();
在SimpleClient中获得 与之关联的SugarClient对象。
关于更新或插⼊判断标准是，主键是否有值。如果主键有值且在数据库中存在该条记录，则执⾏更新，否则执⾏插⼊。
4. 删除
删除在实际开发过程中是⼀个⾮常重要的功能点，所以如何快速有效的删除数据也是⼀件很重要的事。那么，就来看看如何执⾏删除吧：
public bool Delete(Expression<Func<T,bool>> whereExpression);
public bool Delete(T deleteObj);
public bool DeleteById([Dynamic]dynamic id);
public bool DeleteByIds([Dynamic(new[] { fal, true })] dynamic[] ids);
删除没有其他需要注意的地⽅，第⼀个是条件删除，所有满⾜条件的都要删除。第⼆个删除单个对象，后⾯两个根据主键删除对象。
悄悄吐槽⼀下，主键的地⽅⽤object会⽐较好⼀点，因为动态对象会增加⼀次装箱拆箱的过程。
当然了，删除也有AsDeleteable⽅法。IDeleteable接⼝特别提供了根据sql语句删除的⽅法，除此之外没有别的需要注意的地⽅了。小学生卡通图片
5. 查询
⼀个好的ORM框架，⾄少五分功⼒在查询上，如何更快更准的查询成为了现在开发对ORM框架的要求。同时简单易⽤更是程序员对ORM的期望。
那么我们来看看SqlSugar在查询上的功⼒吧：
public bool IsAny(Expression<Func<T, bool>> whereExpression);// 查询是否存在符合条件的数据
public int Count(Expression<Func<T, bool>> whereExpression);// 获取满⾜条件的数量
心惊肉跳
public T GetById([Dynamic] dynamic id);//根据主键获取⼀个实例
public bool IsAny(Expression<Func<T, bool>> whereExpression);//返回满⾜条件的⼀个对象
public List GetList();// 以List的形式返回所有数据
public List GetList(Expression<Func<T, bool>> whereExpression);//返回符合条件的所有数据
分页获取数据：
public List<T>GetPageList(Expression<Func<T,bool>> whereExpression, PageModel page);
public List<T>GetPageList(Expression<Func<T,bool>> whereExpression, PageModel page, Expression<Func<T,object>> orderByExpression =null, Ord erByType orderByType = OrderByType.Asc);
public List<T>GetPageList(List<IConditionalModel> conditionalList, PageModel page);
public List<T>GetPageList(List<IConditionalModel> conditionalList, PageModel page, Expression<Func<T,object>> orderByExpression =null, OrderByTy pe orderByType = OrderByType.Asc);
其中IConditionModel是⼀个空的接⼝，⽤来定义规范查询规范，实际上使⽤的是类：
public class ConditionalModel: IConditionalModel
{
public ConditionalModel()
{
this.ConditionalType = ConditionalType.Equal;
}
public string FieldName {get;t;}
public string FieldValue {get;t;}
public ConditionalType ConditionalType {get;t;}
public Func<string,object> FieldValueConvertFunc {get;t;}
}
那么，我们看⼀下 ConditionType，定义了各种判断依据：
public enum ConditionalType
{
咳嗽头疼
Equal=0,
Like=1,
GreaterThan =2,
GreaterThanOrEqual =3,
LessThan=4,
LessThanOrEqual =5,
In=6,
NotIn=7,
LikeLeft=8,
LikeRight=9,
NoEqual=10,
IsNullOrEmpty=11,
IsNot=12,
NoLike =13,
}
那么我们简单看⼀下 使⽤IConditionModel进⾏分页是怎样的效果：
var list = personClient.GetPageList(new List<IConditionalModel>
{
new ConditionalModel
{
FieldName ="Age",
FieldValue ="3",
ConditionalType = ConditionalType.LessThan
}
}, pageModel);
⽣成如下SQL语句：
SELECT COUNT(1)FROM(SELECT`Id`,`Name`,`Age`FROM`Person`WHERE Age <@ConditionalAge0) CountTable
SELECT`Id`,`Name`,`Age`FROM`Person`WHERE Age <@ConditionalAge0LIMIT0,2
可以看出两者并没有区别，只不过是不同的查询习惯。
6. 总结
按照之前的习惯，到⽬前应该可以结束了。但是SqlSugar还有⼀些很重要的地⽅没有介绍，所以就加个下期预告
下⼀篇将为⼤家分析SqlSugar的⼀些更⾼级的内容，查询的⾼级模式、事务以及批量操作好，总结⼀下这⼀篇，我们在这⼀篇看到了SqlSugar在增删改查上的亮点，可以说更贴合实际业务需求开发。嗯，悄悄给个赞。
再有三篇的内容《C# 数据操作系列》就要完结了。从下⼀系列开始，就要步⼊⼯作中最重要的技术栈了：Asp Core。这是可以写⼊简历的。嗯，没错。下⼀系列计划以实战的形式介绍asp core的知识点和设置。
