FreeSql.Extensions.BaseEntity 3.5.210

dotnet add package FreeSql.Extensions.BaseEntity --version 3.5.210
                    
NuGet\Install-Package FreeSql.Extensions.BaseEntity -Version 3.5.210
                    
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.210" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FreeSql.Extensions.BaseEntity" Version="3.5.210" />
                    
Directory.Packages.props
<PackageReference Include="FreeSql.Extensions.BaseEntity" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add FreeSql.Extensions.BaseEntity --version 3.5.210
                    
#r "nuget: FreeSql.Extensions.BaseEntity, 3.5.210"
                    
#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.
#addin nuget:?package=FreeSql.Extensions.BaseEntity&version=3.5.210
                    
Install as a Cake Addin
#tool nuget:?package=FreeSql.Extensions.BaseEntity&version=3.5.210
                    
Install as a Cake Tool

<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.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.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
Shinya.Orm.FreeSql

Shinya.Framework

JetyDu.BaseDB

Package Description

Dolite

A simple web framework base on asp.net 6

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.210 0 11 hours ago
3.5.210-preview20250626 161 13 days ago
3.5.209 198 19 days ago
3.5.208 159 22 days ago
3.5.207 313 a month ago
3.5.206 345 2 months ago
3.5.205 209 2 months ago
3.5.204-preview20250428 162 2 months ago
3.5.204-preview20250425 119 2 months ago
3.5.203 254 3 months ago
3.5.202 305 3 months ago
3.5.201 233 3 months ago
3.5.200 195 3 months ago
3.5.109 225 4 months ago
3.5.108 307 4 months ago
3.5.107 273 4 months ago
3.5.106 271 5 months ago
3.5.105 184 5 months ago
3.5.105-preview20250116 130 6 months ago
3.5.104 134 6 months ago
3.5.103 264 6 months ago
3.5.103-preview20241226 135 6 months ago
3.5.103-preview20241224 108 7 months ago
3.5.103-preview20241205 156 7 months ago
3.5.102 350 7 months ago
3.5.101 220 7 months ago
3.2.833 1,741 7/15/2024
3.2.832 700 6/27/2024
3.2.830 212 6/19/2024
3.2.825 903 5/20/2024
3.2.822 211 5/12/2024
3.2.821 322 4/10/2024
3.2.820 292 3/26/2024
3.2.815 358 2/27/2024
3.2.812 305 2/1/2024
3.2.810 320 1/14/2024
3.2.808 356 12/20/2023
3.2.807-preview20231219 111 12/19/2023
3.2.805 429 11/15/2023
3.2.802 284 10/27/2023
3.2.801 353 9/21/2023
3.2.700 1,408 8/13/2023
3.2.698 389 7/6/2023
3.2.697 671 6/6/2023
3.2.696 270 5/30/2023
3.2.695 421 5/5/2023
3.2.693 1,325 3/29/2023
3.2.690 622 3/2/2023
3.2.687 1,449 1/24/2023
3.2.685 870 12/20/2022
3.2.684 499 12/2/2022
3.2.683 639 11/20/2022
3.2.682 3,064 10/17/2022
3.2.681 681 10/12/2022
3.2.680 737 9/25/2022
3.2.669 761 9/7/2022
3.2.666 897 8/30/2022
3.2.665 2,723 7/4/2022
3.2.664 796 6/14/2022
3.2.662 690 6/9/2022
3.2.661 730 6/1/2022
3.2.651 690 5/24/2022
3.2.640 690 5/13/2022
3.2.610 902 5/6/2022
3.2.609 657 5/5/2022
3.2.603 611 4/29/2022
3.2.500 816 4/12/2022
3.0.100 1,294 12/17/2021
2.6.100 857 8/31/2021
2.5.200 1,096 6/5/2021
2.5.100 725 5/7/2021
2.3.200 1,518 3/5/2021
2.3.106 599 3/4/2021
2.3.100 632 2/19/2021
2.0.105 877 12/7/2020
2.0.102 671 12/2/2020
2.0.101 1,195 11/26/2020
2.0.0-preview1120 410 11/19/2020
2.0.0-preview1119 418 11/18/2020
2.0.0-preview1115 594 11/13/2020
2.0.0-preview1109 412 11/6/2020
2.0.0-preview1106 385 11/4/2020
2.0.0-preview1105 457 11/4/2020
2.0.0-preview1026 377 10/26/2020
1.10.3 873 11/6/2020
1.10.1 743 10/22/2020
1.10.0-preview1020 405 10/16/2020
1.10.0-preview1001 472 9/29/2020
1.9.1 621 11/6/2020
1.9.0 768 9/23/2020
1.9.0-preview0920 495 9/20/2020
1.9.0-preview0906 532 9/5/2020
1.8.2 683 11/6/2020
1.8.1 903 8/26/2020
1.7.1 868 8/1/2020
1.7.0 764 7/27/2020
1.6.0 1,085 6/27/2020
1.5.0 878 5/24/2020
1.5.0-preview0525 448 5/23/2020
1.5.0-preview0521 494 5/20/2020
1.5.0-preview0509 435 5/8/2020
1.5.0-preview0502 477 5/2/2020
1.4.0 748 4/26/2020
1.4.0-preview0424 420 4/23/2020
1.4.0-preview0423 432 4/22/2020
1.4.0-preview0422 416 4/21/2020
1.4.0-preview0415 437 4/14/2020
1.4.0-preview0413 426 4/13/2020
1.3.6 730 4/12/2020
1.3.5 730 4/7/2020
1.3.4 753 4/1/2020
1.3.0-preview8 434 3/12/2020
1.2.1 845 3/6/2020
1.2.0-preview5 447 2/24/2020
1.2.0-preview3 434 2/23/2020
1.1.0 861 1/31/2020
1.0.1 841 1/3/2020
1.0.0 769 12/25/2019
0.12.21 797 12/16/2019
0.12.20 722 12/14/2019
0.12.18 777 12/12/2019
0.12.16 754 12/10/2019
0.12.12 1,083 12/9/2019
0.12.11 861 12/8/2019
0.12.9 798 12/6/2019
0.12.8 800 12/5/2019
0.12.7 748 12/3/2019
0.12.6 728 12/1/2019
0.12.5 746 11/25/2019
0.12.3 723 11/23/2019
0.11.24 742 11/21/2019
0.11.23 752 11/20/2019
0.11.22 735 11/19/2019
0.11.21 736 11/18/2019
0.11.20 725 11/17/2019
0.11.19 777 11/17/2019
0.11.18 767 11/15/2019
0.11.12 784 11/13/2019
0.11.11 764 11/11/2019
0.11.9 787 11/6/2019
0.11.6 741 11/4/2019
0.11.5 729 11/1/2019
0.11.4 732 10/30/2019
0.11.3 752 10/29/2019
0.11.2 760 10/23/2019
0.11.1 740 10/23/2019
0.10.15 747 10/21/2019
0.10.14 763 10/16/2019
0.10.13 760 10/14/2019
0.10.12 769 10/11/2019
0.10.11 796 10/9/2019
0.10.10 743 10/8/2019
0.10.9 769 10/8/2019
0.10.8 764 10/8/2019
0.10.7 739 10/6/2019
0.10.6 742 9/29/2019
0.10.5 765 9/29/2019
0.10.4 746 9/26/2019
0.10.3 757 9/26/2019
0.10.2 763 9/24/2019
0.10.1 753 9/23/2019
0.9.18 782 9/20/2019
0.9.17 781 9/19/2019
0.9.16 796 9/18/2019
0.9.15 783 9/12/2019
0.9.11 761 9/10/2019
0.9.10 761 9/10/2019
0.9.7 785 9/6/2019