Skip to content
Branch: master
Find file History

readme.md

前言

尝试过 ado.net、dapper、ef,以及Repository仓储,甚至自己还写过生成器工具,以便做常规CRUD操作。

它们日常操作不方便之处:

  • 每次使用前需要声明,再操作;

  • 很多人一个实体类,对应一个操作类(或DAL、DbContext、Repository);

BaseEntity 是一种极简单的 CodeFirst 开发方式,特别对单表或多表CRUD,利用继承节省了每个实体类的重复属性(创建时间、ID等字段),软件删除等功能,进行 crud 操作时不必时常考虑仓储的使用;

本文介绍 BaseEntity 一种极简约的 CRUD 操作方法。

功能特点

  • 自动迁移实体结构(CodeFirst),到数据库;

  • 直接操作实体的方法,进行 CRUD 操作;

  • 简化用户定义实体类型,省去主键、常用字段的配置(如CreateTime、UpdateTime);

  • 实现单表、多表查询的软删除逻辑;

声明

dotnet add package FreeSql.Extensions.BaseEntity

dotnet add package FreeSql.Provider.Sqlite

1、定义一个主键 int 并且自增的实体类型,BaseEntity TKey 指定为 int/long 时,会认为主键是自增;

public class UserGroup : BaseEntity<UserGroup, int>
{
    public string GroupName { get; set; }
}

如果不想主键是自增键,可以重写属性:

public class UserGroup : BaseEntity<UserGroup, int>
{
    [Column(IsIdentity = false)] 
    public override int Id { get; set; }
    public string GroupName { get; set; }
}

有关更多实体的特性配置,请参考资料:https://github.com/2881099/FreeSql/wiki/%e5%ae%9e%e4%bd%93%e7%89%b9%e6%80%a7

2、定义一个主键 Guid 的实体类型,保存数据时会自动产生有序不重复的 Guid 值(不用自己指定 Guid.NewGuid());

public class User : BaseEntity<UserGroup, Guid>
{
    public string UserName { get; set; }
}

CRUD 使用

//添加
var item = new UserGroup { GroupName = "组一" };
item.Insert();

//更新
item.GroupName = "组二";
item.Update();

//添加或更新
item.Save();

//软删除
item.Delete();

//恢复软删除
item.Restore();

//根据主键获取对象
var item = UserGroup.Find(1);

//查询数据
var items = UserGroup.Where(a => a.Id > 10).ToList();

实体类型.Select 是一个查询对象,使用方法和 FreeSql.ISelect 一样;

支持多表查询时,软删除条件会附加在每个表中;

有关更多查询方法,请参考资料:https://github.com/2881099/FreeSql/wiki/%e6%9f%a5%e8%af%a2

You can’t perform that action at this time.