C# 数据操作系列 - 15 SqlSugar 增删改查详解
- 前言
继上一篇,以及上上篇,我们对SqlSugar有了一个大概的认识,但是这并不完美,因为那些都是理论知识,无法描述我们工程开发中实际情况。而这一篇,将带领小伙伴们一起试着写一个能在工程中使用的模板类。 - 创建一个Client
SqlSugar在操作的时候需要一个Client,用来管理数据库连接,并操作数据库。所以我们写一个DbContext用来创建Client:
- 插入数据
对于一个程序而言,数据就像是血液一样重要。对于ORM框架,插入是一切来源的基础。所以我们先来看看SqlSugar的插入是怎样的吧:
2.1 简单的插入模式
public bool Insert(T insertObj);
public bool InsertRange(T[] insertObjs);
public bool InsertRange(List insertObjs);
这是SqlSugar在SimpleClient里提供的两个默认插入方法,一个是插入单个实体对象,一个是插入一组对象。
默认情况下,SqlSugar插入并不会将主键返回给数据。如果后续操作需要当前数据的主键,则可以调用另外一个方法:
public IInsertable AsInsertable(T insertObj);
public IInsertable AsInsertable(T[] insertObjs);
public IInsertable AsInsertable(List insertObjs);
这种模式与SimpleClient的普通插入模式不同,它并不会直接执行插入动作,需要手动调用并执行插入动作:
long ExecuteReturnBigIdentity();
int ExecuteReturnIdentity();
执行动作,然后返回主键值,不会更新实体。
有一点值得特别注意:
所有会返回主键的插入都只针对单个数据,如果一次插入多个数据,并不会返回主键信息也无法将主键信息更新入实体中。
以上都是全列插入,SqlSugar还提供了只插入部分列和忽略某些列两种模式:
IInsertable InsertColumns(Expression> columns);// 满足条件的插入,其他列则不插入
IInsertable InsertColumns(params string[] columns);//插入指定列名
IInsertable IgnoreColumns(Expression> columns);// 忽略满足条件的列,插入其他列
IInsertable IgnoreColumns(params string[] columns);// 忽略这几个列
IInsertable IgnoreColumns(bool ignoreNullColumn, bool isOffIdentity = false);//指定是否忽略Null列,并是否强制插入主键
- 更新或插入
介绍完插入,那么来介绍一下更新。正所谓,没有更新数据就是一滩死水,有了更新数据才有了变化。所以,就让我们来看看如何优雅的更新数据吧:
public bool Update(T updateObj);
public bool UpdateRange(T[] updateObjs);
public bool UpdateRange(List updateObjs);
传入实体,直接更新到数据库中,需要注意的是这种更新模式只需要保证主键有值,且与之对应即可。
public IUpdateable AsUpdateable(T[] updateObjs);
public IUpdateable AsUpdateable(T updateObj);
public IUpdateable AsUpdateable(List updateObjs);
然后可以针对这些今天更多的操作:
只更新某些列:
IUpdateable SetColumns(Expression> columns);
更新示例:
IUpdateable SetColumns(Expression> columns);
IUpdateable UpdateColumns(params string[] columns);
IUpdateable UpdateColumns(Expression> columns);
传入要更新的实际列名。其中 object 用来接一个匿名对象,其中属性名字就是要更新的值。
不更新某些列
IUpdateable IgnoreColumns(params string[] columns);// 忽略传入的列名
IUpdateable IgnoreColumns(Expression> columns);// 用匿名对象表示要忽略的列名
IUpdateable IgnoreColumns(bool ignoreAllNullColumns, bool isOffIdentity = false, bool ignoreAllDefaultValue = false);// 设置是否忽略Null列,是否强制更新主键,是否忽略所有默认值列
条件更新
IUpdateable Where(Expression> expression);
IUpdateable Where(string fieldName, string conditionalType, object fieldValue);
IUpdateable Where(string whereSql, object parameters = null);
IUpdateable WhereColumns(Expression> columns);
IUpdateable WhereColumns(string columnName);
IUpdateable WhereColumns(string[] columnNames);
来,简单猜一猜这几个是什么意思呢?
可以说很简单明了的几种条件设置模式,lambda表示筛选更新数据,字段值判断条件更新。
其中 conditionType的值,推荐使用 ConditionalType枚举的值。
ISaveable Saveable(T saveObject) where T : class, new();
ISaveable Saveable(List saveObjects) where T : class, new();
不过这个方法是在SugarClient里,我们可以通过:
关于更新或插入判断标准是,主键是否有值。如果主键有值且在数据库中存在该条记录,则执行更新,否则执行插入。
- 删除
删除在实际开发过程中是一个非常重要的功能点,所以如何快速有效的删除数据也是一件很重要的事。那么,就来看看如何执行删除吧:
public bool Delete(Expression> whereExpression);
public bool Delete(T deleteObj);
public bool DeleteById([Dynamic] dynamic id);
public bool DeleteByIds([Dynamic(new[] { false, true })] dynamic[] ids);
删除没有其他需要注意的地方,第一个是条件删除,所有满足条件的都要删除。第二个删除单个对象,后面两个根据主键删除对象。
悄悄吐槽一下,主键的地方用object会比较好一点,因为动态对象会增加一次装箱拆箱的过程。
当然了,删除也有AsDeleteable方法。IDeleteable接口特别提供了根据sql语句删除的方法,除此之外没有别的需要注意的地方了。
- 查询
一个好的ORM框架,至少五分功力在查询上,如何更快更准的查询成为了现在开发对ORM框架的要求。同时简单易用更是程序员对ORM的期望。
那么我们来看看SqlSugar在查询上的功力吧:
public bool IsAny(Expression> whereExpression);// 查询是否存在符合条件的数据
public int Count(Expression> whereExpression);// 获取满足条件的数量
public T GetById([Dynamic] dynamic id);//根据主键获取一个实例
public bool IsAny(Expression> whereExpression);//返回满足条件的一个对象
public List GetList();// 以List的形式返回所有数据
public List GetList(Expression> whereExpression);//返回符合条件的所有数据
分页获取数据:
public List GetPageList(Expression> whereExpression, PageModel page);
public List GetPageList(Expression> whereExpression, PageModel page, Expression> orderByExpression = null, OrderByType orderByType = OrderByType.Asc);
public List GetPageList(List conditionalList, PageModel page);
public List GetPageList(List conditionalList, PageModel page, Expression> orderByExpression = null, OrderByType orderByType = OrderByType.Asc);
其中IConditionModel是一个空的接口,用来定义规范查询规范,实际上使用的是类:
SELECT COUNT(1) FROM (SELECT ,, FROM WHERE Age < @ConditionalAge0 ) CountTable
SELECT ,, FROM WHERE Age < @ConditionalAge0 LIMIT 0,2
可以看出两者并没有区别,只不过是不同的查询习惯。
- 总结
按照之前的习惯,到目前应该可以结束了。但是SqlSugar还有一些很重要的地方没有介绍,所以就加个下期预告
下一篇将为大家分析SqlSugar的一些更高级的内容,查询的高级模式、事务以及批量操作
好,总结一下这一篇,我们在这一篇看到了SqlSugar在增删改查上的亮点,可以说更贴合实际业务需求开发。嗯,悄悄给个赞。
再有三篇的内容《C# 数据操作系列》就要完结了。从下一系列开始,就要步入工作中最重要的技术栈了:Asp.net Core。这是可以写入简历的。嗯,没错。下一系列计划以实战的形式介绍asp.net core的知识点和设置。
原文地址https://www.cnblogs.com/c7jie/p/12952759.html
版权声明:
本文来源网络,所有图片文章版权属于原作者,如有侵权,联系删除。
本文网址:https://www.mushiming.com/mjsbk/5157.html