update readme

This commit is contained in:
28810
2020-04-24 23:13:50 +08:00
parent 2825f8acd2
commit 2db061b27c
4 changed files with 182 additions and 30 deletions

View File

@ -1,5 +1,5 @@
<p align="center">
<img height="160" src="https://github.com/2881099/FreeSql/blob/master/logo.png?raw=true"/>
<img height="160" src="https://images.cnblogs.com/cnblogs_com/FreeSql/1656841/o_200424151316logo.png"/>
</p>
FreeSql 是功能强大的对象关系映射技术(O/RM),支持 .NETCore 2.1+ 或 .NETFramework 4.0+ 或 Xamarin
@ -8,7 +8,7 @@ FreeSql 是功能强大的对象关系映射技术(O/RM),支持 .NETCore 2.1+
[![nuget](https://img.shields.io/nuget/v/FreeSql.svg?style=flat-square)](https://www.nuget.org/packages/FreeSql) [![stats](https://img.shields.io/nuget/dt/FreeSql.svg?style=flat-square)](https://www.nuget.org/stats/packages/FreeSql?groupby=Version) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/2881099/FreeSql/master/LICENSE.txt)
## Features
## Features
- [x] 支持 CodeFirst 迁移,哪怕使用 Access 数据库也支持;
- [x] 支持 DbFirst 从数据库导入实体类,[安装实体类生成工具](https://github.com/2881099/FreeSql/wiki/DbFirst)
@ -18,7 +18,7 @@ FreeSql 是功能强大的对象关系映射技术(O/RM),支持 .NETCore 2.1+
- [x] 支持 读写分离、分表分库、过滤器、乐观锁、悲观锁;
- [x] 支持 MySql/SqlServer/PostgreSQL/Oracle/Sqlite/达梦数据库/Access
## Documentation
## 📖 Documentation
| | |
| - | - |
@ -27,14 +27,14 @@ FreeSql 是功能强大的对象关系映射技术(O/RM),支持 .NETCore 2.1+
| <img src="https://user-images.githubusercontent.com/16286519/55138263-06921480-516e-11e9-8da9-81f18a18b694.png" width="30" height="46"/> | [《Repository》](https://github.com/2881099/FreeSql/wiki/Repository) \| [《UnitOfWork》](https://github.com/2881099/FreeSql/wiki/%e5%b7%a5%e4%bd%9c%e5%8d%95%e5%85%83) \| [《AOP》](https://github.com/2881099/FreeSql/wiki/AOP) \| [《DbContext》](https://github.com/2881099/FreeSql/wiki/DbContext) |
| <img src="https://user-images.githubusercontent.com/16286519/55138284-0eea4f80-516e-11e9-8764-29264807f402.png" width="30" height="46"/> | [《读写分离》](https://github.com/2881099/FreeSql/wiki/%e8%af%bb%e5%86%99%e5%88%86%e7%a6%bb) \| [《分区分表》](https://github.com/2881099/FreeSql/wiki/%e5%88%86%e5%8c%ba%e5%88%86%e8%a1%a8) \| [《黑科技》](https://github.com/2881099/FreeSql/wiki/%E9%AA%9A%E6%93%8D%E4%BD%9C) \| [《常见问题》](https://github.com/dotnetcore/FreeSql/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98) \| [*更新日志*](https://github.com/2881099/FreeSql/wiki/%e6%9b%b4%e6%96%b0%e6%97%a5%e5%bf%97) |
> FreeSql 提供多种使用习惯,请根据实际情况选择团队合适的一种:
> 💿 FreeSql 提供多种使用习惯,请根据实际情况选择团队合适的一种:
- 要么FreeSql原始用法
- 要么[FreeSql.Repository](https://github.com/2881099/FreeSql/wiki/Repository),仓储+工作单元习惯;
- 要么[FreeSql.DbContext](https://github.com/2881099/FreeSql/wiki/DbContext)有点像efcore的使用习惯
- 要么[FreeSql.BaseEntity](https://github.com/2881099/FreeSql/tree/master/Examples/base_entity),求简单使用这个;
> 学习项目
> 💿 学习项目
- [zhontai.net Admin后台管理系统](https://github.com/zhontai/Admin.Core)
- [😃 A simple and practical CMS implememted by .NET Core 2.2](https://github.com/luoyunchong/lin-cms-dotnetcore)
@ -44,7 +44,7 @@ FreeSql 是功能强大的对象关系映射技术(O/RM),支持 .NETCore 2.1+
<img src="https://images.cnblogs.com/cnblogs_com/kellynic/133561/o_200417052121functions08.png"/>
</p>
## Quick start
## 🚀 Quick start
> dotnet add package FreeSql.Provider.Sqlite
@ -83,7 +83,7 @@ class Tag {
}
```
## Query
## 🔍 Query
```csharp
//OneToOne、ManyToOne
fsql.Select<Tag>()
@ -130,33 +130,30 @@ fsql.Select<Song>()
```
[More..](https://github.com/2881099/FreeSql/wiki/%e8%a1%a8%e8%be%be%e5%bc%8f%e5%87%bd%e6%95%b0)
## Repository & UnitOfWork
## 📦 Repository
> dotnet add package FreeSql.Repository
```csharp
using (var uow = fsql.CreateUnitOfWork()) {
var repo1 = uow.GetRepository<Song>();
var repo2 = uow.GetRepository<Tag>();
var repo = uow.GetRepository<Tag>();
repo.DbContextOptions.EnableAddOrUpdateNavigateList = true;
repo2.DbContextOptions.EnableAddOrUpdateNavigateList = true;
repo2.Insert(new Tag {
Name = "testaddsublist",
Tags = new[] {
repo.Insert(new Tag {
Name = "testaddsublist",
Tags = new[] {
new Tag { Name = "sub1" },
new Tag { Name = "sub2" },
new Tag {
Name = "sub3",
Tags = new[] {
Name = "sub3",
Tags = new[] {
new Tag { Name = "sub3_01" }
}
}
}
});
uow.Commit();
}
}
}
});
```
## Performance
## 💪 Performance
FreeSql Query & Dapper Query
```shell
@ -184,7 +181,7 @@ Elapsed: 00:00:00.6495301; Query Entity Counts: 131072; ORM: Dapper
[More..](https://github.com/2881099/FreeSql/wiki/%e6%80%a7%e8%83%bd)
## Contributors
## 👯 Contributors
[systemhejiyong](https://github.com/systemhejiyong)、
[LambertW](https://github.com/LambertW)、
@ -202,7 +199,7 @@ Elapsed: 00:00:00.6495301; Query Entity Counts: 131072; ORM: Dapper
QQ群4336577
## Donation
## 💕 Donation
L*y 58元、花花 88元、麦兜很乖 50元、网络来者 2000元、John 99.99元、alex 666元、bacongao 36元、无名 100元、Eternity 188元、无名 10元、⌒.Helper~..oO 66元、习惯与被习惯 100元、无名 100元