FreeSql.Repository 3.2.821

dotnet add package FreeSql.Repository --version 3.2.821
NuGet\Install-Package FreeSql.Repository -Version 3.2.821
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.Repository" Version="3.2.821" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FreeSql.Repository --version 3.2.821
#r "nuget: FreeSql.Repository, 3.2.821"
#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.Repository as a Cake Addin
#addin nuget:?package=FreeSql.Repository&version=3.2.821

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

<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/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:

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

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  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 is compatible.  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 is compatible.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 is compatible. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net40 is compatible.  net403 was computed.  net45 is compatible.  net451 was computed.  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.

NuGet packages (65)

Showing the top 5 NuGet packages that depend on FreeSql.Repository:

Package Downloads
FreeSql.All

FreeSql 全家桶,懒人专用

HandeSoft.Core.Abstract

Package Description

EE.Core.Dao

Package Description

XUCore.NetCore.FreeSql

.NET Core FreeSql 数据库仓储

LDFCore.Net5.Platform

Package Description

GitHub repositories (13)

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

Repository Stars
dotnetcore/BootstrapBlazor
A set of enterprise-class UI components based on Bootstrap and Blazor
LightCountry/TokenPay
✅一款同时支持动态和静态收款地址收取TRX、USDT-TRC20、ETH系列区块链所有代币的支付解决方案!✅A payment solution that supports both dynamic and static payee addresses to receive TRX, USDT-TRC20, all tokens of ETH series blockchain!
yc-l/yc.boilerplate
YC. Boilerplate is a set of loose coupling, flexible combination, complete functions, convenient development, and reduces the workload of development.
Deali-Axy/StarBlog
☀☀功能完整的博客系统。后端基于.Net6+AspNetCore框架,遵循RESTFul接口规范,前端基于Vue+ElementUI开发,搭配全套开发笔记文章,可作为 .Net Core 入门项目学习~
LeonKou/NetPro
🌈An enhanced version with clean architecture of asp.netcore,efficiently manage startup,Support for netcore3.1/6.0
Version Downloads Last updated
3.2.821 465 4/10/2024
3.2.820 1,173 3/26/2024
3.2.816-preview20240322 124 3/22/2024
3.2.816-preview20240314 166 3/14/2024
3.2.815 1,066 2/27/2024
3.2.812 1,064 2/1/2024
3.2.811-preview20240126 297 1/26/2024
3.2.811-preview20240120 339 1/20/2024
3.2.810 1,474 1/14/2024
3.2.808 2,572 12/20/2023
3.2.807-preview20231219 486 12/19/2023
3.2.805 7,238 11/15/2023
3.2.802 7,751 10/27/2023
3.2.801 7,424 9/21/2023
3.2.700 9,324 8/13/2023
3.2.698 8,788 7/6/2023
3.2.697 8,024 6/6/2023
3.2.696 2,330 5/30/2023
3.2.695 8,634 5/5/2023
3.2.693 20,907 3/29/2023
3.2.690 2,207 3/2/2023
3.2.687 13,658 1/24/2023
3.2.685 10,170 12/20/2022
3.2.684 4,153 12/2/2022
3.2.683 5,039 11/20/2022
3.2.682 38,362 10/17/2022
3.2.681 2,745 10/12/2022
3.2.680 15,195 9/25/2022
3.2.669 9,404 9/7/2022
3.2.666 12,492 8/30/2022
3.2.665 50,395 7/4/2022
3.2.664 27,103 6/14/2022
3.2.662 1,922 6/9/2022
3.2.661 2,563 6/1/2022
3.2.651 2,885 5/24/2022
3.2.640 6,208 5/13/2022
3.2.610 1,942 5/6/2022
3.2.609 1,783 5/5/2022
3.2.603 1,675 4/29/2022
3.2.500 17,491 4/12/2022
3.0.100 19,098 12/17/2021
2.6.100 105,520 8/31/2021
2.5.200 72,375 6/5/2021
2.5.100 42,720 5/7/2021
2.3.200 53,106 3/5/2021
2.3.106 1,939 3/4/2021
2.3.100 3,432 2/19/2021
2.0.105 23,144 12/7/2020
2.0.102 4,978 12/2/2020
2.0.101 12,794 11/26/2020
2.0.0-preview1120 1,041 11/19/2020
2.0.0-preview1119 1,086 11/18/2020
2.0.0-preview1115 1,082 11/13/2020
2.0.0-preview1109 1,492 11/6/2020
2.0.0-preview1106 1,038 11/4/2020
2.0.0-preview1105 1,164 11/4/2020
2.0.0-preview1026 1,072 10/26/2020
1.10.3 7,468 11/6/2020
1.10.1 3,200 10/22/2020
1.10.0-preview1020 1,098 10/16/2020
1.10.0-preview1001 1,125 9/29/2020
1.9.1 1,651 11/6/2020
1.9.0 5,313 9/23/2020
1.9.0-preview0920 1,139 9/20/2020
1.9.0-preview0906 1,149 9/5/2020
1.8.2 1,577 11/6/2020
1.8.1 7,357 8/26/2020
1.7.1 3,159 8/1/2020
1.7.0 2,100 7/27/2020
1.6.0 7,269 6/27/2020
1.5.0 7,483 5/24/2020
1.5.0-preview0525 1,085 5/23/2020
1.5.0-preview0521 1,160 5/20/2020
1.5.0-preview0509 1,459 5/8/2020
1.5.0-preview0502 1,165 5/2/2020
1.4.0 2,743 4/26/2020
1.4.0-preview0424 1,033 4/23/2020
1.4.0-preview0423 1,023 4/22/2020
1.4.0-preview0422 997 4/21/2020
1.4.0-preview0415 1,207 4/14/2020
1.4.0-preview0413 1,114 4/13/2020
1.3.6 2,113 4/12/2020
1.3.5 1,797 4/7/2020
1.3.4 2,198 4/1/2020
1.3.0-preview8 1,214 3/12/2020
1.2.1 2,624 3/6/2020
1.2.0-preview5 1,271 2/24/2020
1.2.0-preview3 1,072 2/23/2020
1.1.0 2,437 1/31/2020
1.0.1 1,821 1/3/2020
1.0.0 1,464 12/25/2019
0.12.21 1,446 12/16/2019
0.12.20 1,338 12/14/2019
0.12.18 1,438 12/12/2019
0.12.16 2,566 12/10/2019
0.12.12 1,470 12/9/2019
0.12.11 1,278 12/8/2019
0.12.9 1,338 12/6/2019
0.12.8 1,306 12/5/2019
0.12.7 1,352 12/3/2019
0.12.6 1,365 12/1/2019
0.12.5 1,457 11/25/2019
0.12.3 1,353 11/23/2019
0.11.24 1,306 11/21/2019
0.11.23 1,326 11/20/2019
0.11.22 1,345 11/19/2019
0.11.21 1,286 11/18/2019
0.11.20 1,379 11/17/2019
0.11.19 1,340 11/17/2019
0.11.18 1,359 11/15/2019
0.11.12 1,266 11/13/2019
0.11.11 1,299 11/11/2019
0.11.9 1,292 11/6/2019
0.11.6 1,293 11/4/2019
0.11.5 1,370 11/1/2019
0.11.4.2 1,303 10/31/2019
0.11.4 1,295 10/30/2019
0.11.3 1,370 10/29/2019
0.11.2 1,343 10/23/2019
0.11.1 1,333 10/23/2019
0.10.15 1,326 10/21/2019
0.10.14 1,376 10/16/2019
0.10.13 1,305 10/14/2019
0.10.12 1,272 10/11/2019
0.10.11 1,304 10/9/2019
0.10.10 1,353 10/8/2019
0.10.9 1,265 10/8/2019
0.10.8 1,314 10/8/2019
0.10.7 1,312 10/6/2019
0.10.6 1,291 9/29/2019
0.10.5 1,254 9/29/2019
0.10.4 1,302 9/26/2019
0.10.3 1,281 9/26/2019
0.10.2 1,394 9/24/2019
0.10.1 1,330 9/23/2019
0.9.18 1,313 9/20/2019
0.9.17 1,335 9/19/2019
0.9.16 1,340 9/18/2019
0.9.15 1,308 9/12/2019
0.9.11 1,296 9/10/2019
0.9.10 1,404 9/10/2019
0.9.7 1,538 9/6/2019