FreeSql.Repository
3.5.101
See the version list below for details.
dotnet add package FreeSql.Repository --version 3.5.101
NuGet\Install-Package FreeSql.Repository -Version 3.5.101
<PackageReference Include="FreeSql.Repository" Version="3.5.101" />
paket add FreeSql.Repository --version 3.5.101
#r "nuget: FreeSql.Repository, 3.5.101"
// Install FreeSql.Repository as a Cake Addin #addin nuget:?package=FreeSql.Repository&version=3.5.101 // Install FreeSql.Repository as a Cake Tool #tool nuget:?package=FreeSql.Repository&version=3.5.101
<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.
<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:
- Use FreeSql, keep the original usage.
- Use FreeSql.DbContext, Repository + UnitOfWork.
- Use FreeSql.BaseEntity, Simple mode.
Some open source projects that use FreeSql:
- Zhontai.net Management System
- A simple CMS implemented by .NET8
- AIBPM workflow
- NetAdmin A rapid development framework based on C#12/.NET9 and 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()
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()
});
🚁 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);
}
💪 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
👯 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
Product | Versions 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. net9.0 is compatible. |
.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. |
-
.NETCoreApp 3.1
- FreeSql.DbContext (>= 3.5.101)
-
.NETFramework 4.0
- FreeSql.DbContext (>= 3.5.101)
-
.NETFramework 4.5
- FreeSql.DbContext (>= 3.5.101)
-
.NETStandard 2.0
- FreeSql.DbContext (>= 3.5.101)
-
.NETStandard 2.1
- FreeSql.DbContext (>= 3.5.101)
-
net5.0
- FreeSql.DbContext (>= 3.5.101)
-
net6.0
- FreeSql.DbContext (>= 3.5.101)
-
net7.0
- FreeSql.DbContext (>= 3.5.101)
-
net8.0
- FreeSql.DbContext (>= 3.5.101)
-
net9.0
- FreeSql.DbContext (>= 3.5.101)
NuGet packages (79)
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.Platform
Package Description |
GitHub repositories (16)
Showing the top 5 popular GitHub repositories that depend on FreeSql.Repository:
Repository | Stars |
---|---|
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!
|
|
TeslaFly01/SmartSqlT
🔥🔥🔥 SmartSQL 是一款方便、快捷的数据库文档查询、导出工具!该工具从最初支持CHM文档格式开始,通过不断地探索开发、集思广益和不断改进,又陆续支持Word、Excel、PDF、Html、Xml、Json、MarkDown等文档格式的导出。同时支持SqlServer、MySql、PostgreSQL、SQLite等多种数据库的文档查询和导出功能。
|
|
Deali-Axy/StarBlog
☀☀功能完整的博客系统。后端基于.Net6+AspNetCore框架,遵循RESTFul接口规范,前端基于Vue+ElementUI开发,搭配全套开发笔记文章,可作为 .Net Core 入门项目学习~
|
|
yc-l/yc.boilerplate
YC. Boilerplate is a set of loose coupling, flexible combination, complete functions, convenient development, and reduces the workload of development.
|
|
withsalt/BilibiliLiveTools
Bilibili(B站)无人值守直播工具。自动登录,自动获取直播推流地址,自动推流(使用ffmpeg),可以用于电脑、树莓派等设备无人值守直播。
|
Version | Downloads | Last updated |
---|---|---|
3.5.103-preview20241224 | 0 | 12/24/2024 |
3.5.103-preview20241205 | 159 | 12/5/2024 |
3.5.102 | 1,956 | 12/4/2024 |
3.5.101 | 510 | 12/1/2024 |
3.5.100-preview20241108 | 123 | 11/8/2024 |
3.2.833 | 14,803 | 7/15/2024 |
3.2.832 | 8,352 | 6/27/2024 |
3.2.830 | 813 | 6/19/2024 |
3.2.825 | 5,895 | 5/20/2024 |
3.2.822 | 2,155 | 5/12/2024 |
3.2.821 | 4,257 | 4/10/2024 |
3.2.820 | 6,597 | 3/26/2024 |
3.2.815 | 8,030 | 2/27/2024 |
3.2.812 | 1,639 | 2/1/2024 |
3.2.810 | 2,391 | 1/14/2024 |
3.2.808 | 4,932 | 12/20/2023 |
3.2.807-preview20231219 | 582 | 12/19/2023 |
3.2.805 | 15,528 | 11/15/2023 |
3.2.802 | 19,470 | 10/27/2023 |
3.2.801 | 10,747 | 9/21/2023 |
3.2.700 | 14,926 | 8/13/2023 |
3.2.698 | 11,420 | 7/6/2023 |
3.2.697 | 9,872 | 6/6/2023 |
3.2.696 | 2,504 | 5/30/2023 |
3.2.695 | 9,944 | 5/5/2023 |
3.2.693 | 26,828 | 3/29/2023 |
3.2.690 | 2,365 | 3/2/2023 |
3.2.687 | 16,014 | 1/24/2023 |
3.2.685 | 11,373 | 12/20/2022 |
3.2.684 | 5,431 | 12/2/2022 |
3.2.683 | 5,337 | 11/20/2022 |
3.2.682 | 41,331 | 10/17/2022 |
3.2.681 | 3,086 | 10/12/2022 |
3.2.680 | 16,606 | 9/25/2022 |
3.2.669 | 10,615 | 9/7/2022 |
3.2.666 | 14,906 | 8/30/2022 |
3.2.665 | 53,948 | 7/4/2022 |
3.2.664 | 30,064 | 6/14/2022 |
3.2.662 | 1,971 | 6/9/2022 |
3.2.661 | 2,750 | 6/1/2022 |
3.2.651 | 3,035 | 5/24/2022 |
3.2.640 | 6,414 | 5/13/2022 |
3.2.610 | 2,012 | 5/6/2022 |
3.2.609 | 1,843 | 5/5/2022 |
3.2.603 | 1,715 | 4/29/2022 |
3.2.500 | 18,118 | 4/12/2022 |
3.0.100 | 19,754 | 12/17/2021 |
2.6.100 | 108,858 | 8/31/2021 |
2.5.200 | 77,808 | 6/5/2021 |
2.5.100 | 44,304 | 5/7/2021 |
2.3.200 | 55,320 | 3/5/2021 |
2.3.106 | 2,005 | 3/4/2021 |
2.3.100 | 3,509 | 2/19/2021 |
2.0.105 | 24,523 | 12/7/2020 |
2.0.102 | 5,237 | 12/2/2020 |
2.0.101 | 13,946 | 11/26/2020 |
2.0.0-preview1120 | 1,097 | 11/19/2020 |
2.0.0-preview1119 | 1,143 | 11/18/2020 |
2.0.0-preview1115 | 1,126 | 11/13/2020 |
2.0.0-preview1109 | 1,570 | 11/6/2020 |
2.0.0-preview1106 | 1,070 | 11/4/2020 |
2.0.0-preview1105 | 1,207 | 11/4/2020 |
2.0.0-preview1026 | 1,104 | 10/26/2020 |
1.10.3 | 7,655 | 11/6/2020 |
1.10.1 | 3,331 | 10/22/2020 |
1.10.0-preview1020 | 1,152 | 10/16/2020 |
1.10.0-preview1001 | 1,166 | 9/29/2020 |
1.9.1 | 1,703 | 11/6/2020 |
1.9.0 | 6,334 | 9/23/2020 |
1.9.0-preview0920 | 1,171 | 9/20/2020 |
1.9.0-preview0906 | 1,207 | 9/5/2020 |
1.8.2 | 1,611 | 11/6/2020 |
1.8.1 | 7,581 | 8/26/2020 |
1.7.1 | 3,247 | 8/1/2020 |
1.7.0 | 2,156 | 7/27/2020 |
1.6.0 | 8,888 | 6/27/2020 |
1.5.0 | 7,696 | 5/24/2020 |
1.5.0-preview0525 | 1,133 | 5/23/2020 |
1.5.0-preview0521 | 1,223 | 5/20/2020 |
1.5.0-preview0509 | 1,511 | 5/8/2020 |
1.5.0-preview0502 | 1,226 | 5/2/2020 |
1.4.0 | 2,814 | 4/26/2020 |
1.4.0-preview0424 | 1,099 | 4/23/2020 |
1.4.0-preview0423 | 1,089 | 4/22/2020 |
1.4.0-preview0422 | 1,047 | 4/21/2020 |
1.4.0-preview0415 | 1,305 | 4/14/2020 |
1.4.0-preview0413 | 1,170 | 4/13/2020 |
1.3.6 | 2,184 | 4/12/2020 |
1.3.5 | 1,833 | 4/7/2020 |
1.3.4 | 2,250 | 4/1/2020 |
1.3.0-preview8 | 1,253 | 3/12/2020 |
1.2.1 | 2,683 | 3/6/2020 |
1.2.0-preview5 | 1,316 | 2/24/2020 |
1.2.0-preview3 | 1,116 | 2/23/2020 |
1.1.0 | 2,514 | 1/31/2020 |
1.0.1 | 1,870 | 1/3/2020 |
1.0.0 | 1,506 | 12/25/2019 |
0.12.21 | 1,481 | 12/16/2019 |
0.12.20 | 1,372 | 12/14/2019 |
0.12.18 | 1,476 | 12/12/2019 |
0.12.16 | 2,603 | 12/10/2019 |
0.12.12 | 1,505 | 12/9/2019 |
0.12.11 | 1,314 | 12/8/2019 |
0.12.9 | 1,373 | 12/6/2019 |
0.12.8 | 1,342 | 12/5/2019 |
0.12.7 | 1,390 | 12/3/2019 |
0.12.6 | 1,399 | 12/1/2019 |
0.12.5 | 1,500 | 11/25/2019 |
0.12.3 | 1,390 | 11/23/2019 |
0.11.24 | 1,341 | 11/21/2019 |
0.11.23 | 1,366 | 11/20/2019 |
0.11.22 | 1,382 | 11/19/2019 |
0.11.21 | 1,339 | 11/18/2019 |
0.11.20 | 1,412 | 11/17/2019 |
0.11.19 | 1,381 | 11/17/2019 |
0.11.18 | 1,406 | 11/15/2019 |
0.11.12 | 1,302 | 11/13/2019 |
0.11.11 | 1,348 | 11/11/2019 |
0.11.9 | 1,329 | 11/6/2019 |
0.11.6 | 1,325 | 11/4/2019 |
0.11.5 | 1,406 | 11/1/2019 |
0.11.4.2 | 1,335 | 10/31/2019 |
0.11.4 | 1,327 | 10/30/2019 |
0.11.3 | 1,402 | 10/29/2019 |
0.11.2 | 1,386 | 10/23/2019 |
0.11.1 | 1,369 | 10/23/2019 |
0.10.15 | 1,365 | 10/21/2019 |
0.10.14 | 1,418 | 10/16/2019 |
0.10.13 | 1,356 | 10/14/2019 |
0.10.12 | 1,305 | 10/11/2019 |
0.10.11 | 1,343 | 10/9/2019 |
0.10.10 | 1,391 | 10/8/2019 |
0.10.9 | 1,318 | 10/8/2019 |
0.10.8 | 1,350 | 10/8/2019 |
0.10.7 | 1,347 | 10/6/2019 |
0.10.6 | 1,324 | 9/29/2019 |
0.10.5 | 1,296 | 9/29/2019 |
0.10.4 | 1,347 | 9/26/2019 |
0.10.3 | 1,320 | 9/26/2019 |
0.10.2 | 1,432 | 9/24/2019 |
0.10.1 | 1,380 | 9/23/2019 |
0.9.18 | 1,349 | 9/20/2019 |
0.9.17 | 1,368 | 9/19/2019 |
0.9.16 | 1,387 | 9/18/2019 |
0.9.15 | 1,343 | 9/12/2019 |
0.9.11 | 1,333 | 9/10/2019 |
0.9.10 | 1,452 | 9/10/2019 |
0.9.7 | 1,590 | 9/6/2019 |