FreeSql.DbContext 3.2.811-preview20240120

🦄 FreeSql, The first AOT ORM!

FreeSql is a powerful O/RM component, supports .NET Core 2.1+, .NET Framework 4.0+, Xamarin, And AOT.

Member project of .NET Core Community nuget stats GitHub license

English | 中文

  • 🛠 Support CodeFirst data migration.
  • 💻 Support DbFirst import entity class from database, or use Generation Tool.
  • ⛳ Support advanced type mapping, such as PostgreSQL array type, etc.
  • 🌲 Support expression functions, and customizable analysis.
  • 🏁 Support one-to-many and many-to-many navigation properties, include and lazy loading.
  • 📃 Support Read/Write separation, Splitting Table/Database, Global filters, Optimistic and pessimistic locker.
  • 🌳 Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite/Firebird/达梦/人大金仓/南大通用/虚谷/神舟通用/翰高/ClickHouse/QuestDB/MsAccess, etc.

QQ Groups:561616019(available)、4336577(full)、8578575(full)、52508226(full)

📚 Documentation

Get started  |  Select  |  Update  |  Insert  |  Delete  |  FAQ  
Expression  |  CodeFirst  |  DbFirst  |  Filters  |  AOP  
Repository  |  UnitOfWork  |  DbContext  |  ADO  
Read/Write  |  Splitting Table  |  Hide tech  |  Update Notes  

Please select a development mode:

Some open source projects that use FreeSql:

🚀 Quick start

dotnet add package FreeSql.Provider.Sqlite

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
  .UseConnectionString(FreeSql.DataType.Sqlite, @"Data Source=document.db")
  .UseAutoSyncStructure(true) //automatically synchronize the entity structure to the database
  .Build(); //be sure to define as singleton mode

class Song {
  [Column(IsIdentity = true)]
  public int Id { get; set; }
  public string Title { get; set; }
  public string Url { get; set; }
  public DateTime CreateTime { get; set; }
  
  public ICollection<Tag> Tags { get; set; }
}
class Song_tag {
  public int Song_id { get; set; }
  public Song Song { get; set; }
  
  public int Tag_id { get; set; }
  public Tag Tag { get; set; }
}
class Tag {
  [Column(IsIdentity = true)]
  public int Id { get; set; }
  public string Name { get; set; }
  
  public int? Parent_id { get; set; }
  public Tag Parent { get; set; }
  
  public ICollection<Song> Songs { get; set; }
  public ICollection<Tag> Tags { get; set; }
}

🔎 Query

//OneToOne、ManyToOne
fsql.Select<Tag>().Where(a => a.Parent.Parent.Name == "English").ToList();

//OneToMany
fsql.Select<Tag>().IncludeMany(a => a.Tags, then => then.Where(sub => sub.Name == "foo")).ToList();

//ManyToMany
fsql.Select<Song>()
  .IncludeMany(a => a.Tags, then => then.Where(sub => sub.Name == "foo"))
  .Where(s => s.Tags.Any(t => t.Name == "Chinese"))
  .ToList();

//Other
fsql.Select<YourType>()
  .Where(a => a.IsDelete == 0)
  .WhereIf(keyword != null, a => a.UserName.Contains(keyword))
  .WhereIf(role_id > 0, a => a.RoleId == role_id)
  .Where(a => a.Nodes.Any(t => t.Parent.Id == t.UserId))
  .Count(out var total)
  .Page(page, size)
  .OrderByDescending(a => a.Id)
  .ToList()

More..

fsql.Select<Song>().Where(a => new[] { 1, 2, 3 }.Contains(a.Id)).ToList();

fsql.Select<Song>().Where(a => a.CreateTime.Date == DateTime.Today).ToList();

fsql.Select<Song>().OrderBy(a => Guid.NewGuid()).Limit(10).ToList();

fsql.Select<Song>().ToList(a => new
{
    a.Id,
    Tags = fsql.Select<Tag>().ToList(),
    SongTags = fsql.Select<SongTag>().Where(b => b.TopicId == a.Id).ToList()
});

More..

🚁 Repository

dotnet add package FreeSql.Repository

[Transactional]
public void Add() {
  var repo = ioc.GetService<BaseRepository<Tag>>();
  repo.DbContextOptions.EnableCascadeSave = true;

  var item = new Tag {
    Name = "testaddsublist",
    Tags = new[] {
      new Tag { Name = "sub1" },
      new Tag { Name = "sub2" }
    }
  };
  repo.Insert(item);
}

Reference: Use TransactionalAttribute and UnitOfWorkManager in ASP.NET Core to Achieve the Multiple Transaction Propagation.

💪 Performance

FreeSql Query & Dapper Query

Elapsed: 00:00:00.6733199; Query Entity Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.4554230; Query Tuple Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.6846146; Query Dynamic Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.6818111; Query Entity Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.6060042; Query Tuple Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.4211323; Query ToList<Tuple> Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:01.0236285; Query Dynamic Counts: 131072; ORM: FreeSql*

FreeSql ToList & Dapper Query

Elapsed: 00:00:00.6707125; ToList Entity Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.6495301; Query Entity Counts: 131072; ORM: Dapper

More..

👯 Contributors

And other friends who made important suggestions for this project, they include:

systemhejiyong, LambertW, mypeng1985, stulzq, movingsam, ALer-R, zouql, 深圳|凉茶, densen2014, LiaoLiaoWuJu, hd2y, tky753, feijie999, constantine, JohnZhou2020, mafeng8, VicBilibily, Soar, quzhen91, homejun, d4ilys etc.

💕 Donation

L*y 58元、花花 88元、麦兜很乖 50元、网络来者 2000元、John 99.99元、alex 666元、bacongao 36元、无名 100元、Eternity 188元、无名 10元、⌒.Helper~..oO 66元、习惯与被习惯 100元、无名 100元、蔡易喋 88.88元、中讯科技 1000元、Good Good Work 24元、炽焰 6.6元、Nothing 100元、兰州天擎赵 500元、哈利路亚 300元、 无名 100元、蛰伏 99.99元、TCYM 66.66元、MOTA 5元、LDZXG 30元、Near 30元、建爽 66元、无名 200元、LambertWu 100元、无名 18.88元、乌龙 50元、无名 100元、陳怼怼 66.66元、陳怼怼 66.66元、丁淮 100元、李伟坚-Excel催化剂 100元、白狐 6.66元、她微笑的脸y 30元、Eternity²º²¹ 588元、夜归柴门 88元、蔡易喋 666.66元、 *礼 10元、litrpa 88元、Alax CHOW 200元、Daily 66元、k*t 66元、蓝 100元、*菜 10元、生命如歌 1000元、山鸡 88元、平凡 100元、大树 1000元、软软的毛毛虫 66.66元、问卷星 2000元、与你无关 5000元

Thank you for your donation

🗄 License

MIT

Showing the top 20 packages that depend on FreeSql.DbContext.

Packages Downloads
FreeSql.Cloud
提供跨数据库访问,分布式事务TCC、SAGA解决方案,支持 .NET Core 2.1+, .NET Framework 4.0+.
13
FreeSql.Cloud
提供跨数据库访问,分布式事务TCC、SAGA解决方案,支持 .NET Core 2.1+, .NET Framework 4.0+.
16
FreeSql.Cloud
提供跨数据库访问,分布式事务TCC、SAGA解决方案,支持 .NET Core 2.1+, .NET Framework 4.0+.
17
FreeSql.Extensions.BaseEntity
BaseEntity 是一种极简单的 CodeFirst 开发方式,特别对单表或多表CRUD,利用继承节省了每个实体类的重复属性(创建时间、ID等字段),软件删除等功能,进行 crud 操作时不必时常考虑仓储的使用.
13
FreeSql.Extensions.BaseEntity
BaseEntity 是一种极简单的 CodeFirst 开发方式,特别对单表或多表CRUD,利用继承节省了每个实体类的重复属性(创建时间、ID等字段),软件删除等功能,进行 crud 操作时不必时常考虑仓储的使用.
14
FreeSql.Repository
FreeSql Implementation of General Repository, Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite, and read/write separation、and split table.
13
FreeSql.Repository
FreeSql Implementation of General Repository, Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite, and read/write separation、and split table.
14
FreeSql.Repository
FreeSql Implementation of General Repository, Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite, and read/write separation、and split table.
15
FreeSql.Repository
FreeSql Implementation of General Repository, Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite, and read/write separation、and split table.
16
FreeSql.Repository
FreeSql Implementation of General Repository, Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite/Firebird/Clickhouse/QuestDB/达梦/人大金仓/南大通用/虚谷/神舟通用/翰高/Access, and read/write separation、and split table.
14
FreeSql.Repository
FreeSql Implementation of General Repository, Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite/达梦/Access, and read/write separation、and split table.
13

.NET Framework 4.0

.NET Standard 2.1

.NET Standard 2.0

.NET 8.0

.NET 7.0

.NET 6.0

.NET 5.0

.NET Core 3.1

.NET Framework 4.5

Version Downloads Last updated
3.5.106 1 02/23/2025
3.5.105 0 02/10/2025
3.5.105-preview20250116 0 01/16/2025
3.5.104 0 01/14/2025
3.5.103 0 01/07/2025
3.5.103-preview20241226 4 12/29/2024
3.5.103-preview20241224 4 12/26/2024
3.5.103-preview20241205 4 12/13/2024
3.5.102 5 12/13/2024
3.5.101 4 12/12/2024
3.5.100 4 12/13/2024
3.5.100-preview20241128 4 12/12/2024
3.5.100-preview20241127 4 12/03/2024
3.5.100-preview20241124 6 12/12/2024
3.5.100-preview20241123 6 12/04/2024
3.5.100-preview20241113 7 11/14/2024
3.5.100-preview20241112 7 11/14/2024
3.5.100-preview20241108 7 11/14/2024
3.5.100-preview20241101 9 11/14/2024
3.5.100-preview20240825 8 11/14/2024
3.5.100-preview20240815 7 11/14/2024
3.5.100-preview20240810 6 11/14/2024
3.5.100-preview20240808 5 12/11/2024
3.5.100-preview20240725 5 12/13/2024
3.2.833 8 11/14/2024
3.2.832 5 11/14/2024
3.2.830 5 12/12/2024
3.2.825 7 11/14/2024
3.2.822 11 05/28/2024
3.2.821 6 11/14/2024
3.2.820 10 05/28/2024
3.2.816-preview20240322 8 05/28/2024
3.2.816-preview20240314 10 05/28/2024
3.2.815 10 05/28/2024
3.2.812 8 05/28/2024
3.2.811 8 02/04/2024
3.2.811-preview20240126 8 05/28/2024
3.2.811-preview20240120 10 05/28/2024
3.2.810 10 05/28/2024
3.2.808 13 02/04/2024
3.2.806-preview20231213 10 01/27/2024
3.2.805 13 05/28/2024
3.2.803 9 12/10/2023
3.2.802 8 12/10/2023
3.2.801 7 05/28/2024
3.2.700 9 05/28/2024
3.2.698 6 05/28/2024
3.2.697 10 06/16/2023
3.2.696 12 05/28/2024
3.2.695 11 05/28/2024
3.2.693 10 04/14/2023
3.2.690 10 05/28/2024
3.2.687 10 05/28/2024
3.2.685 13 05/28/2024
3.2.684 6 05/28/2024
3.2.683 9 05/28/2024
3.2.682 10 05/28/2024
3.2.681 10 05/28/2024
3.2.680 7 05/28/2024
3.2.669 9 05/28/2024
3.2.666 11 06/16/2023
3.2.665 9 01/27/2024
3.2.664 10 05/28/2024
3.2.662 7 05/28/2024
3.2.661 9 05/28/2024
3.2.651 10 05/28/2024
3.2.640 10 05/28/2024
3.2.610 10 05/28/2024
3.2.609 8 05/28/2024
3.2.603 9 05/28/2024
3.2.500 11 05/28/2024
3.0.100 13 05/28/2024
2.6.100 9 05/28/2024
2.5.200 9 05/28/2024
2.5.100 9 05/28/2024
2.3.200 10 05/28/2024
2.3.106 10 05/28/2024
2.3.100 10 05/28/2024
2.0.105 5 11/14/2024
2.0.102 10 05/28/2024
2.0.101 9 05/28/2024
2.0.0-preview1120 6 11/14/2024
2.0.0-preview1119 6 11/14/2024
2.0.0-preview1115 3 12/03/2024
2.0.0-preview1109 6 11/14/2024
2.0.0-preview1106 7 11/14/2024
2.0.0-preview1105 5 11/14/2024
2.0.0-preview1026 5 12/12/2024
1.10.3 12 06/01/2024
1.10.1 11 06/01/2024
1.10.0-preview1020 6 12/12/2024
1.10.0-preview1001 4 12/09/2024
1.9.1 11 06/01/2024
1.9.0 12 06/01/2024
1.9.0-preview0920 8 11/14/2024
1.9.0-preview0906 6 11/14/2024
1.8.2 9 06/01/2024
1.8.1 12 06/01/2024
1.7.1 10 06/01/2024
1.7.0 7 06/01/2024
1.6.0 11 06/01/2024
1.5.0 6 06/01/2024
1.5.0-preview0525 7 11/14/2024
1.5.0-preview0521 8 11/14/2024
1.5.0-preview0509 8 11/14/2024
1.5.0-preview0502 5 12/09/2024
1.4.0 8 05/09/2024
1.4.0-preview0424 6 11/14/2024
1.4.0-preview0423 6 11/14/2024
1.4.0-preview0422 9 11/14/2024
1.4.0-preview0415 8 11/14/2024
1.4.0-preview0413 6 11/14/2024
1.3.6 7 06/01/2024
1.3.5 10 06/01/2024
1.3.4 6 06/01/2024
1.3.0-preview8 10 05/28/2024
1.2.1 10 06/01/2024
1.2.0-preview5 13 05/28/2024
1.2.0-preview3 6 11/14/2024
1.1.0 7 06/01/2024
1.0.1 7 06/01/2024
1.0.0 17 06/01/2024
0.12.21 9 05/28/2024
0.12.20 7 05/28/2024
0.12.18 9 05/28/2024
0.12.16 8 05/28/2024
0.12.12 8 05/28/2024
0.12.11 9 05/28/2024
0.12.9 13 05/09/2024
0.12.8 9 06/01/2024
0.12.7 7 06/01/2024
0.12.6 8 06/01/2024
0.12.5 8 05/09/2024
0.12.3 12 06/01/2024
0.11.24 8 05/28/2024
0.11.23 9 05/28/2024
0.11.22 8 05/28/2024
0.11.21 11 05/28/2024
0.11.20 11 05/28/2024
0.11.19 8 05/28/2024
0.11.18 8 05/28/2024
0.11.12 7 05/28/2024
0.11.11 11 05/28/2024
0.11.9 8 06/01/2024
0.11.6 8 06/01/2024
0.11.5 12 06/01/2024
0.11.4.2 9 06/01/2024
0.11.4 7 06/01/2024
0.11.3 7 06/01/2024
0.11.2 13 05/12/2024
0.11.1 15 05/12/2024
0.10.15 6 05/28/2024
0.10.14 8 05/28/2024
0.10.13 9 05/28/2024
0.10.12 9 05/28/2024
0.10.11 10 05/28/2024
0.10.10 7 05/29/2024
0.10.9 9 06/01/2024
0.10.8 7 06/01/2024
0.10.7 11 05/12/2024
0.10.6 14 06/01/2024
0.10.5 9 06/01/2024
0.10.4 9 06/01/2024
0.10.3 10 06/01/2024
0.10.2 10 05/08/2024
0.10.1 7 06/01/2024
0.9.18 9 06/01/2024
0.9.17 12 06/01/2024
0.9.16 13 06/01/2024
0.9.15 9 06/01/2024
0.9.11 8 06/01/2024
0.9.10 11 06/01/2024
0.9.7 8 11/14/2024