FreeSql 3.5.108

dotnet add package FreeSql --version 3.5.108                
NuGet\Install-Package FreeSql -Version 3.5.108                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FreeSql" Version="3.5.108" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FreeSql --version 3.5.108                
#r "nuget: FreeSql, 3.5.108"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FreeSql as a Cake Addin
#addin nuget:?package=FreeSql&version=3.5.108

// Install FreeSql as a Cake Tool
#tool nuget:?package=FreeSql&version=3.5.108                

<h1 align="center"> 🦄 FreeSql, The first AOT ORM!</h1><div align="center">

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

<p> <span>English</span> |
<a href="README.zh-CN.md">中文</a> </p>

</div>

  • 🛠 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/DuckDB/TDengine/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  |  Dynamic Operations  |  ADO  
Read/Write  |  Splitting Table  |  Hide tech  |  Update Notes  

Please select a development mode:

Some open source projects that use FreeSql:

<p align="center"> <img src="https://github.com/dotnetcore/FreeSql/raw/master/functions13.png"/> </p>

🚀 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

<a href="https://contributors-img.web.app/image?repo=dotnetcore/FreeSql"> <img src="https://contributors-img.web.app/image?repo=dotnetcore/FreeSql" /> </a>

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元、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

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net40 is compatible.  net403 was computed.  net45 is compatible.  net451 is compatible.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.0

    • No dependencies.
  • .NETFramework 4.5

    • No dependencies.
  • .NETFramework 4.5.1

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.
  • .NETStandard 2.1

    • No dependencies.

NuGet packages (199)

Showing the top 5 NuGet packages that depend on FreeSql:

Package Downloads
FreeSql.DbContext

FreeSql is the ORM in .NetCore, .NetFramework, And Xamarin. It supports Mysql, Postgresql, SqlServer, Oracle, Sqlite, Firebird, Clickhouse, DuckDB, TDengine, QuestDB, Odbc, Oledb, 达梦, 人大金仓, 南大通用, 虚谷, 神舟通用, 翰高, And Access

FreeSql.Provider.MySql

FreeSql 数据库实现,基于 MySql 5.6,Ado.Net 驱动是 MySql.Data(Oracle官方)

FreeSql.Provider.SqlServer

FreeSql 数据库实现,基于 SqlServer 2005+,并根据版本适配分页方法:row_number 或 offset fetch next

FreeSql.Provider.PostgreSQL

FreeSql 数据库实现,基于 PostgreSQL 9.5

FreeSql.Provider.Sqlite

FreeSql 数据库实现,基于 Sqlite 3.0,支持 .NetCore、.NetFramework、Xamarin

GitHub repositories (28)

Showing the top 5 popular GitHub repositories that depend on FreeSql:

Repository Stars
DotNetNext/SqlSugar
.Net aot ORM Fastest ORM DB2 Hana Simple Easy VB.NET Sqlite orm Oracle ORM Mysql Orm 虚谷数据库 postgresql ORm SqlServer oRm 达梦 ORM 人大金仓 ORM 神通ORM C# ORM , C# ORM .NET ORM NET5 ORM .NET6 ORM ClickHouse orm QuestDb ,TDengine ORM,OceanBase orm,GaussDB orm ,Tidb orm Object/Relational Mapping
SkyAPM/SkyAPM-dotnet
The .NET/.NET Core instrument agent for Apache SkyWalking
dotnetcore/AgileConfig
基于.NET Core开发的轻量级分布式配置中心 / .NET Core lightweight configuration server
dotnetcore/HttpReports
HttpReports is an APM (application performance monitor) system for .Net Core.
bing-framework/Bing.NetCore
Bing是基于 .net core 3.1 的框架,旨在提升团队的开发输出能力,由常用公共操作类(工具类、帮助类)、分层架构基类,第三方组件封装,第三方业务接口封装等组成。
Version Downloads Last updated
3.5.108 783 3/11/2025
3.5.107 1,989 3/4/2025
3.5.106 3,362 2/18/2025
3.5.105 3,263 2/10/2025
3.5.105-preview20250116 1,108 1/16/2025
3.5.104 4,418 1/14/2025
3.5.103 2,374 1/7/2025
3.5.103-preview20241226 910 12/26/2024
3.5.103-preview20241224 683 12/24/2024
3.5.103-preview20241205 917 12/5/2024
3.5.102 10,979 12/4/2024
3.5.101 2,252 12/1/2024
3.2.833 42,044 7/15/2024
3.2.832 16,083 6/27/2024
3.2.830 3,239 6/19/2024
3.2.825 15,445 5/20/2024
3.2.822 5,323 5/12/2024
3.2.821 14,694 4/10/2024
3.2.820 11,257 3/26/2024
3.2.815 17,591 2/27/2024
3.2.812 6,884 2/1/2024
3.2.810 9,424 1/14/2024
3.2.808 23,500 12/20/2023
3.2.805 25,103 11/15/2023
3.2.802 27,578 10/27/2023
3.2.801 18,701 9/21/2023
3.2.700 23,883 8/13/2023
3.2.698 21,203 7/6/2023
3.2.697 19,940 6/6/2023
3.2.696 8,037 5/30/2023
3.2.695 29,654 5/5/2023
3.2.693 55,309 3/29/2023
3.2.690 9,924 3/2/2023
3.2.687 35,048 1/24/2023
3.2.685 27,136 12/20/2022
3.2.684 19,319 12/2/2022
3.2.683 17,058 11/20/2022
3.2.682 77,831 10/17/2022
3.2.681 37,841 10/12/2022
3.2.680 37,741 9/25/2022
3.2.669 32,683 9/7/2022
3.2.666 82,572 8/30/2022
3.2.665 138,801 7/4/2022
3.2.664 46,253 6/14/2022
3.2.662 11,774 6/9/2022
3.2.661 19,841 6/1/2022
3.2.651 20,015 5/24/2022
3.2.640 18,815 5/13/2022
3.2.610 27,909 5/6/2022
3.2.609 12,765 5/5/2022
3.2.603 12,044 4/29/2022
3.2.500 36,003 4/12/2022
3.0.100 84,538 12/17/2021
2.6.100 160,788 8/31/2021
2.5.200 137,973 6/5/2021
2.5.100 66,938 5/7/2021
2.3.200 110,025 3/5/2021
2.3.106 8,593 3/4/2021
2.3.100 18,093 2/19/2021
2.0.105 63,564 12/7/2020
2.0.102 13,145 12/2/2020
2.0.101 23,487 11/26/2020
2.0.0-preview1120 3,443 11/19/2020
2.0.0-preview1119 3,522 11/18/2020
2.0.0-preview1115 3,803 11/13/2020
2.0.0-preview1109 4,542 11/6/2020
2.0.0-preview1106 3,476 11/4/2020
2.0.0-preview1105 3,581 11/4/2020
2.0.0-preview1026 3,659 10/26/2020
1.10.3 18,560 11/6/2020
1.10.1 12,600 10/22/2020
1.10.0-preview1020 3,958 10/16/2020
1.10.0-preview1001 3,623 9/29/2020
1.9.1 8,292 11/6/2020
1.9.0 17,698 9/23/2020
1.9.0-preview0920 3,625 9/20/2020
1.9.0-preview0906 4,666 9/5/2020
1.8.2 7,897 11/6/2020
1.8.1 114,084 8/26/2020
1.7.1 11,268 8/1/2020
1.7.0 8,561 7/27/2020
1.6.0 17,756 6/27/2020
1.5.0 18,313 5/24/2020
1.5.0-preview0525 3,316 5/23/2020
1.5.0-preview0521 3,411 5/20/2020
1.5.0-preview0509 3,959 5/8/2020
1.5.0-preview0502 3,362 5/2/2020
1.4.0 11,490 4/26/2020
1.4.0-preview0424 3,290 4/23/2020
1.4.0-preview0423 3,219 4/22/2020
1.4.0-preview0422 3,296 4/21/2020
1.4.0-preview0415 3,624 4/14/2020
1.4.0-preview0413 3,337 4/13/2020
1.3.6 8,528 4/12/2020
1.3.5 7,072 4/7/2020
1.3.4 8,652 4/1/2020
1.3.0-preview8 3,509 3/12/2020
1.2.1 9,764 3/6/2020
1.2.0-preview5 3,388 2/24/2020
1.1.0 8,298 1/31/2020
1.0.1 9,996 1/3/2020
1.0.0 8,946 12/25/2019
0.12.21 6,498 12/16/2019
0.12.20 6,099 12/14/2019
0.12.19 6,403 12/13/2019
0.12.18 6,445 12/12/2019
0.12.16 7,462 12/10/2019
0.12.15 6,580 12/10/2019
0.12.13 6,342 12/9/2019
0.12.12 6,328 12/9/2019
0.12.11 6,227 12/8/2019
0.12.9 6,077 12/6/2019
0.12.8 6,217 12/5/2019
0.12.7 6,035 12/3/2019
0.12.6 6,467 12/1/2019
0.12.5 6,594 11/25/2019
0.12.3 5,915 11/23/2019
0.11.24 6,455 11/21/2019
0.11.23 6,032 11/20/2019
0.11.22 5,859 11/19/2019
0.11.21 6,354 11/18/2019
0.11.20 6,198 11/17/2019
0.11.19 6,298 11/17/2019
0.11.18 6,230 11/15/2019
0.11.12 6,126 11/13/2019
0.11.11 6,105 11/11/2019
0.11.9 6,501 11/6/2019
0.11.6 6,106 11/4/2019
0.11.5 5,844 11/1/2019
0.11.4 7,290 10/30/2019
0.11.3 6,072 10/29/2019
0.11.2 6,186 10/23/2019
0.11.1 6,068 10/23/2019
0.10.15 5,979 10/21/2019
0.10.14 7,725 10/16/2019
0.10.13 7,218 10/14/2019
0.10.12 6,015 10/11/2019
0.10.11 6,174 10/9/2019
0.10.10 6,164 10/8/2019
0.10.9 6,000 10/8/2019
0.10.8 6,043 10/8/2019
0.10.7 6,177 10/6/2019
0.10.6 6,194 9/29/2019
0.10.5 5,911 9/29/2019
0.10.4 6,077 9/26/2019
0.10.3 6,019 9/26/2019
0.10.2 6,205 9/24/2019
0.10.1 6,029 9/23/2019
0.9.18 6,397 9/20/2019
0.9.17 6,186 9/19/2019
0.9.16 5,579 9/18/2019
0.9.15 5,433 9/12/2019
0.9.11 5,159 9/10/2019
0.9.10 5,223 9/10/2019
0.9.7 6,155 9/6/2019