Dapper.Contrib——更加优雅地使用Dapper进行增删改查
简介Dapper是介于Entity framework与ADO的折中选择。既满足手写查询的高性能需求,又简化了数据库对象映射为内存对象的繁杂工作。Dapper.Contrib是对Dapper的进一步封装,使对象的基本增删改查等操作进一步简化。
为什么使用Dapper.Contrib
如果仅仅使用Dapper,要对一个对象进行insert操作需要如下操作
using (var connection = new SqlConnection("链接字符串"))
{
var users = connection.Execute("insert into Demo (Name,Age) values('张三',23)");
}Dapper.Contrib不需要写sql,操作对象即可
using (var connnection = DbHelper.GetConnection())
{
var result = connnection.Insert(new Demo
{
Age = 23,
Name = "张三",
});
} 使用Dapper.Contrib
工欲善其事,必先利其器。要想不写sql愉快地增删改当然需要前期地配置。
entity配置
public class Demo
{
//不是自动增长主键时使用ExplicitKey
public int Id { get; set; }
public string Name { get; set; }
public int Age { get; set; }
public int ComputedAge => Age * 2;
public int NoWriteCol { get; set; }
}上面的Demo类里面包含了Dapper.Contrib的所有实体配置选项
[*]Table:指定实体对应地数据库表名,可忽略,但是忽略后实体对应地数据库表名会在末尾加个s,Demo对应Demos(感觉画蛇添足了)
[*]Key:指定此列为主键(自动增长主键),可忽略,忽略后默认查找
[*]ExplicitKey:指定此列为主键(不自动增长类型例如guid,ExplicitKey与Key地区别下面会详细讲)
[*]Computed:计算属性,打上此标签,对象地insert,update等操作会忽略此列
[*]Write:需穿一个bool值,false时insert,update等操作会忽略此列(和Computed的作用差不多,看了源码也没发现与Computed有什么不一样的地方,有了解的朋友可以赐教下哈)
Key和ExplicitKey这两项都是指定列为主键的。区别是打上Key特性的列在插入时是不能指定值的,只能是数据库自动增长列,而ExplicitKey特性可以允许在插入时指定值,比如用guid为主键类型,则主键在插入时必须已经生成好。
增删改查
做好上面的配置后就可以进行实体的操作了,Dapper.Contrib与Dapper一样都是拓展了DbConnection对象,方法如下(未列出异步方法)
[*]T Get(id);
[*]IEnumerable GetAll();
[*]int Insert(T obj);
[*]int Insert(Enumerable list);
[*]bool Update(T obj);
[*]bool Update(Enumerable list);
[*]bool Delete(T obj);
[*]bool Delete(Enumerable list);
[*]bool DeleteAll();
值得注意的是,从源码得知,Get方法仅支持单主键查询,如果多主键或者没主键都会报错
if (keyCount > 1)
throw new DataException($"{method}<T> only supports an entity with a single or property");
if (keyCount == 0)
throw new DataException($"{method}<T> only supports an entity with a or an property");
来源:https://www.cnblogs.com/51net/archive/2023/03/12/17208853.html
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页:
[1]