FreeSql.Extensions.BaseEntity 3.5.100-preview20240825

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

// Install FreeSql.Extensions.BaseEntity as a Cake Tool
#tool nuget:?package=FreeSql.Extensions.BaseEntity&version=3.5.100-preview20240825&prerelease                

<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  |  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元、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. 
.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 was computed. 
.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 (5)

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

Package Downloads
JetyDu.BaseDB

Package Description

Dolite

A simple web framework base on asp.net 6

Shinya.Orm.FreeSql

Shinya.Framework

Custom.CommonBase

Package Description

ObservableBaseEntity

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.5.100-preview20240825 134 8/24/2024
3.5.100-preview20240815 110 8/14/2024
3.5.100-preview20240810 103 8/9/2024
3.5.100-preview20240808 97 8/8/2024
3.5.100-preview20240725 71 7/24/2024
3.2.833 1,264 7/15/2024
3.2.832 634 6/27/2024
3.2.830 154 6/19/2024
3.2.825 600 5/20/2024
3.2.822 158 5/12/2024
3.2.821 254 4/10/2024
3.2.820 231 3/26/2024
3.2.815 280 2/27/2024
3.2.812 253 2/1/2024
3.2.810 262 1/14/2024
3.2.808 295 12/20/2023
3.2.807-preview20231219 79 12/19/2023
3.2.805 390 11/15/2023
3.2.802 225 10/27/2023
3.2.801 296 9/21/2023
3.2.700 1,368 8/13/2023
3.2.698 324 7/6/2023
3.2.697 567 6/6/2023
3.2.696 222 5/30/2023
3.2.695 355 5/5/2023
3.2.693 1,277 3/29/2023
3.2.690 576 3/2/2023
3.2.687 1,125 1/24/2023
3.2.685 765 12/20/2022
3.2.684 444 12/2/2022
3.2.683 577 11/20/2022
3.2.682 2,820 10/17/2022
3.2.681 620 10/12/2022
3.2.680 678 9/25/2022
3.2.669 708 9/7/2022
3.2.666 820 8/30/2022
3.2.665 2,398 7/4/2022
3.2.664 728 6/14/2022
3.2.662 627 6/9/2022
3.2.661 666 6/1/2022
3.2.651 624 5/24/2022
3.2.640 628 5/13/2022
3.2.610 828 5/6/2022
3.2.609 596 5/5/2022
3.2.603 550 4/29/2022
3.2.500 740 4/12/2022
3.0.100 1,220 12/17/2021
2.6.100 777 8/31/2021
2.5.200 1,011 6/5/2021
2.5.100 640 5/7/2021
2.3.200 1,439 3/5/2021
2.3.106 519 3/4/2021
2.3.100 546 2/19/2021
2.0.105 796 12/7/2020
2.0.102 577 12/2/2020
2.0.101 1,115 11/26/2020
2.0.0-preview1120 337 11/19/2020
2.0.0-preview1119 343 11/18/2020
2.0.0-preview1115 513 11/13/2020
2.0.0-preview1109 339 11/6/2020
2.0.0-preview1106 307 11/4/2020
2.0.0-preview1105 383 11/4/2020
2.0.0-preview1026 299 10/26/2020
1.10.3 794 11/6/2020
1.10.1 666 10/22/2020
1.10.0-preview1020 325 10/16/2020
1.10.0-preview1001 391 9/29/2020
1.9.1 538 11/6/2020
1.9.0 683 9/23/2020
1.9.0-preview0920 416 9/20/2020
1.9.0-preview0906 454 9/5/2020
1.8.2 602 11/6/2020
1.8.1 800 8/26/2020
1.7.1 785 8/1/2020
1.7.0 682 7/27/2020
1.6.0 934 6/27/2020
1.5.0 789 5/24/2020
1.5.0-preview0525 369 5/23/2020
1.5.0-preview0521 410 5/20/2020
1.5.0-preview0509 354 5/8/2020
1.5.0-preview0502 391 5/2/2020
1.4.0 659 4/26/2020
1.4.0-preview0424 340 4/23/2020
1.4.0-preview0423 348 4/22/2020
1.4.0-preview0422 337 4/21/2020
1.4.0-preview0415 349 4/14/2020
1.4.0-preview0413 346 4/13/2020
1.3.6 645 4/12/2020
1.3.5 639 4/7/2020
1.3.4 662 4/1/2020
1.3.0-preview8 352 3/12/2020
1.2.1 757 3/6/2020
1.2.0-preview5 368 2/24/2020
1.2.0-preview3 348 2/23/2020
1.1.0 774 1/31/2020
1.0.1 752 1/3/2020
1.0.0 681 12/25/2019
0.12.21 706 12/16/2019
0.12.20 635 12/14/2019
0.12.18 688 12/12/2019
0.12.16 668 12/10/2019
0.12.12 880 12/9/2019
0.12.11 766 12/8/2019
0.12.9 714 12/6/2019
0.12.8 708 12/5/2019
0.12.7 662 12/3/2019
0.12.6 638 12/1/2019
0.12.5 658 11/25/2019
0.12.3 639 11/23/2019
0.11.24 653 11/21/2019
0.11.23 664 11/20/2019
0.11.22 647 11/19/2019
0.11.21 647 11/18/2019
0.11.20 641 11/17/2019
0.11.19 685 11/17/2019
0.11.18 680 11/15/2019
0.11.12 699 11/13/2019
0.11.11 675 11/11/2019
0.11.9 697 11/6/2019
0.11.6 656 11/4/2019
0.11.5 630 11/1/2019
0.11.4 642 10/30/2019
0.11.3 663 10/29/2019
0.11.2 671 10/23/2019
0.11.1 652 10/23/2019
0.10.15 654 10/21/2019
0.10.14 672 10/16/2019
0.10.13 671 10/14/2019
0.10.12 678 10/11/2019
0.10.11 710 10/9/2019
0.10.10 657 10/8/2019
0.10.9 677 10/8/2019
0.10.8 676 10/8/2019
0.10.7 648 10/6/2019
0.10.6 651 9/29/2019
0.10.5 676 9/29/2019
0.10.4 656 9/26/2019
0.10.3 666 9/26/2019
0.10.2 676 9/24/2019
0.10.1 664 9/23/2019
0.9.18 692 9/20/2019
0.9.17 697 9/19/2019
0.9.16 704 9/18/2019
0.9.15 693 9/12/2019
0.9.11 674 9/10/2019
0.9.10 670 9/10/2019
0.9.7 692 9/6/2019