FreeSql.Extensions.JsonMap 3.2.807-preview20231219

This is a prerelease version of FreeSql.Extensions.JsonMap.
There is a newer version of this package available.
See the version list below for details.
dotnet add package FreeSql.Extensions.JsonMap --version 3.2.807-preview20231219
                    
NuGet\Install-Package FreeSql.Extensions.JsonMap -Version 3.2.807-preview20231219
                    
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.JsonMap" Version="3.2.807-preview20231219" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FreeSql.Extensions.JsonMap" Version="3.2.807-preview20231219" />
                    
Directory.Packages.props
<PackageReference Include="FreeSql.Extensions.JsonMap" />
                    
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.JsonMap --version 3.2.807-preview20231219
                    
#r "nuget: FreeSql.Extensions.JsonMap, 3.2.807-preview20231219"
                    
#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.
#:package FreeSql.Extensions.JsonMap@3.2.807-preview20231219
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=FreeSql.Extensions.JsonMap&version=3.2.807-preview20231219&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=FreeSql.Extensions.JsonMap&version=3.2.807-preview20231219&prerelease
                    
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/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 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 (25)

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

Package Downloads
HandeSoft.Core.Abstract

Package Description

Shinya.Orm.FreeSql

Shinya.Framework

Cszy.Data.FreeSql

Package Description

YN.DB

Package Description

HJMinimally.Repository.FreeSql

Package Description

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on FreeSql.Extensions.JsonMap:

Repository Stars
luoyunchong/lin-cms-dotnetcore
😃A simple and practical CMS implemented by .NET + FreeSql;前后端分离、Docker部署、OAtuh2授权登录、自动化部署DevOps、自动同步至Gitee、代码生成器、仿掘金专栏
trueai-org/midjourney-proxy
🦄 The world's largest Midjourney drawing API, generating over 1 million drawings daily, supporting Discord Youchuan Midjourney 🐂!
leooneone/aibpm.plus
AIBPM是一个开源的工作流引擎。本项目是后端服务,前端请移步aibpm.ui.plus。
densen2014/Blazor100
Blazor入门100天
Version Downloads Last Updated
3.5.213 369 8/26/2025
3.5.213-preview20250825 65 8/23/2025
3.5.213-preview20250815 147 8/14/2025
3.5.212 987 7/30/2025
3.5.211 560 7/24/2025
3.5.211-preview20250716 142 7/16/2025
3.5.210 887 7/9/2025
3.5.210-preview20250626 185 6/26/2025
3.5.209 1,056 6/21/2025
3.5.208 330 6/17/2025
3.5.207 1,212 5/30/2025
3.5.206 3,431 5/14/2025
3.5.205 1,177 5/4/2025
3.5.204-preview20250428 183 4/28/2025
3.5.204-preview20250425 234 4/25/2025
3.5.203 783 4/19/2025
3.5.202 995 4/8/2025
3.5.201 541 4/1/2025
3.5.200 392 3/27/2025
3.5.109 463 3/19/2025
3.5.108 548 3/11/2025
3.5.107 849 3/4/2025
3.5.106 2,101 2/18/2025
3.5.105 695 2/10/2025
3.5.105-preview20250116 875 1/16/2025
3.5.104 1,229 1/14/2025
3.5.103 336 1/7/2025
3.5.103-preview20241226 157 12/26/2024
3.5.103-preview20241224 116 12/24/2024
3.5.103-preview20241205 144 12/5/2024
3.5.102 2,984 12/4/2024
3.5.101 280 12/1/2024
3.2.833 12,269 7/15/2024
3.2.832 1,277 6/27/2024
3.2.830 503 6/19/2024
3.2.825 2,296 5/20/2024
3.2.822 787 5/12/2024
3.2.821 1,997 4/10/2024
3.2.820 1,298 3/26/2024
3.2.815 6,064 2/27/2024
3.2.812 629 2/1/2024
3.2.810 1,729 1/14/2024
3.2.808 6,832 12/20/2023
3.2.807-preview20231219 225 12/19/2023
3.2.805 2,779 11/15/2023
3.2.802 764 10/27/2023
3.2.801 4,196 9/21/2023
3.2.700 12,370 8/13/2023
3.2.698 2,317 7/6/2023
3.2.697 1,565 6/6/2023
3.2.696 718 5/30/2023
3.2.695 4,508 5/5/2023
3.2.693 5,965 3/29/2023
3.2.690 827 3/2/2023
3.2.687 2,931 1/24/2023
3.2.685 10,818 12/20/2022
3.2.684 1,247 12/2/2022
3.2.683 3,567 11/20/2022
3.2.682 19,452 10/17/2022
3.2.681 3,069 10/12/2022
3.2.680 4,665 9/25/2022
3.2.669 1,247 9/7/2022
3.2.666 1,368 8/30/2022
3.2.665 30,308 7/4/2022
3.2.664 5,056 6/14/2022
3.2.662 745 6/9/2022
3.2.661 890 6/1/2022
3.2.651 856 5/24/2022
3.2.640 1,206 5/13/2022
3.2.610 787 5/6/2022
3.2.609 778 5/5/2022
3.2.603 735 4/29/2022
3.2.500 14,947 4/12/2022
3.0.100 3,027 12/17/2021
2.6.100 53,441 8/31/2021
2.5.200 19,542 6/5/2021
2.5.100 947 5/7/2021
2.3.200 5,448 3/5/2021
2.3.106 725 3/4/2021
2.3.100 789 2/19/2021
2.0.105 7,308 12/7/2020
2.0.102 727 12/2/2020
2.0.101 748 11/26/2020
2.0.0-preview1120 478 11/19/2020
2.0.0-preview1119 460 11/18/2020
2.0.0-preview1115 449 11/13/2020
2.0.0-preview1109 445 11/6/2020
2.0.0-preview1106 428 11/4/2020
2.0.0-preview1105 476 11/4/2020
2.0.0-preview1026 439 10/26/2020
1.10.3 918 11/6/2020
1.10.1 873 10/22/2020
1.10.0-preview1020 459 10/16/2020
1.10.0-preview1001 499 9/29/2020
1.9.1 734 11/6/2020
1.9.0 1,964 9/23/2020
1.9.0-preview0920 546 9/20/2020
1.9.0-preview0906 582 9/5/2020
1.8.2 738 11/6/2020
1.8.1 930 8/26/2020
1.7.1 970 8/1/2020
1.7.0 827 7/27/2020
1.6.0 996 6/27/2020
1.5.0 866 5/24/2020
1.5.0-preview0525 486 5/23/2020
1.5.0-preview0521 530 5/20/2020
1.5.0-preview0509 505 5/8/2020
1.5.0-preview0502 523 5/2/2020
1.4.0 885 4/26/2020
1.4.0-preview0424 493 4/23/2020
1.4.0-preview0423 481 4/22/2020
1.4.0-preview0422 504 4/21/2020
1.4.0-preview0415 504 4/14/2020
1.4.0-preview0413 459 4/13/2020
1.3.6 922 4/12/2020
1.3.5 853 4/7/2020
1.3.4 879 4/1/2020
1.3.0-preview8 529 3/12/2020
1.2.1 830 3/6/2020
1.2.0-preview3 500 2/23/2020
1.1.0 832 1/31/2020
1.0.1 898 1/3/2020
1.0.0 796 12/25/2019
0.12.21 864 12/16/2019
0.12.20 852 12/14/2019
0.12.18 839 12/12/2019
0.12.16 822 12/10/2019
0.12.12 1,205 12/9/2019
0.12.11 845 12/8/2019
0.12.9 831 12/6/2019
0.12.8 770 12/5/2019
0.12.7 791 12/3/2019
0.12.6 837 12/1/2019
0.12.5 821 11/25/2019
0.12.3 873 11/23/2019
0.11.24 828 11/21/2019
0.11.23 857 11/20/2019
0.11.22 799 11/19/2019
0.11.21 881 11/18/2019
0.11.20 857 11/17/2019
0.11.19 840 11/17/2019
0.11.18 802 11/15/2019
0.11.12 837 11/13/2019
0.11.11 806 11/11/2019
0.11.9 869 11/6/2019
0.11.6 849 11/4/2019
0.11.5 855 11/1/2019
0.11.4 844 10/30/2019
0.11.3 911 10/29/2019
0.11.2 898 10/23/2019
0.11.1 839 10/23/2019
0.10.15 863 10/21/2019
0.10.14 935 10/16/2019
0.10.13 876 10/14/2019
0.10.12 867 10/11/2019
0.10.11 842 10/9/2019
0.10.10 839 10/8/2019
0.10.9 873 10/8/2019
0.10.8 813 10/8/2019
0.10.7 811 10/6/2019
0.10.6 844 9/29/2019
0.10.5 836 9/29/2019
0.10.4 854 9/26/2019
0.10.3 827 9/26/2019
0.10.2 862 9/24/2019
0.10.1 858 9/23/2019
0.9.18 871 9/20/2019
0.9.17 868 9/19/2019
0.9.16 900 9/18/2019
0.9.15 947 9/12/2019