FreeSql 以 MIT 开源协议托管于 github：https://github.com/2881099/FreeSql
FreeSql 采用 ExpressionTree 优化读取速读，如果懂技术的你一定知道 .NETCore 技术下除了原生代码，最快就是 Emit 和 ExpressionTree。项目在初期使用的反射+缓存，虽然 .NETCore 优化了反射性能，但经过与Dapper性能测试对比之后，发现仍然有一定差距，改成 ExpresstionTree 后才与 Dapper 性能相当。FreeSql 支持的类型较多，实现 ExpressionTree 的复杂度较大，有兴趣的朋友可以翻阅源代码。
1、返回单条记录
Topic t1 = fsql.Select<Topic>().ToOne();
FreeSql有一个约定，ToOne 永远返回 null 或 有数据的实体对象，ToList 永远返回非 null 的 List<实体类型>
2、返回 List
List<Topic> t1 = fsql.Select<Topic>().ToList();
3、返回 List + 导航属性的数据
List<Topic> t2 = fsql.Select<Topic>().LeftJoin(a => a.Type.Id == a.TypeId).ToList();
//此时会返回普通字段 + 导航对象 Type 的数据
4、指定字段返回
//返回一个字段
List<int> t3 = fsql.Select<Topic>().ToList(a => a.Id);
//返回匿名类
List<匿名类> t4 = fsql.Select<Topic>().ToList(a => new { a.Id, a.Title });
//返回元组
List<(int, string)> t5 = fsql.Select<Topic>().ToList<(int, string)>("id, title");
//返回SQL字段
List<匿名类> t6 = fsql.Select<Topic>().ToList(a => new {
a.Id,
a.Title,
a.Type, //可以直接返回导航属性 Type
cstitle = "substr(a.title, 0, 2)", //将 substr(a.title, 0, 2) 作为查询字段
csnow = Convert.ToDateTime("now()"), //将 now() 作为查询字段
//奇思妙想：怎么查询开窗函数的结果
});
//返回子查询的字段
List<匿名类> t6 = fsql.Select<Topic>().ToList(a => new {
a.Id,
count = fsql.Select<T2>().Count(),
max = fsql.Select<T2>().Max(b => b.Id),
min = fsql.Select<T2>().Min(b => b.Id),
name = fsql.Select<2>().First(b => b.name)
});
5、执行SQL
class xxx {
public int Id { get; set; }
public string Path { get; set; }
public string Title2 { get; set; }
}
List<xxx> t8 = fsql.Ado.Query<xxx>("select * from song");
List<(int, string ,string)> t7 = fsql.Ado.Query<(int, string, string)>("select * from song");
List<dynamic> t9 = fsql.Ado.Query<dynamic>("select * from song");
注意：Ado.Query 的实体特性是无效的，比如 [Column(Name = "xxx")] 无效
6、巧用AsTable
var sql = fsql.Select<User>()
.AsTable((a, b) => "(select * from tb_topic where clicks > 10)")
.Page(1, 10).ToList()
v1.0.1 ISelect 增加 WithSql("select * from user ...") 功能快速代理此方法
7、ToChunk
执行查询，分块返回数据，可减少内存开销。比如读取10万条数据，每次返回100条处理。
var testlist1 = fsql.Select<Song>().OrderBy(a => a.Id).ToList();
var testlist2 = new List<Song>();
fsql.Select<Song>().OrderBy(a => a.Id).ToChunk(100, list =>
{
testlist2.AddRange(list);
});
//这里示范，最终 testlist1 与 testlist2 返回的数据相同。
API
| 方法 | 返回值 | 参数 | 描述 |
|---|---|---|---|
| ToSql | string | 返回即将执行的SQL语句 | |
| ToList | List<T1> | 执行SQL查询，返回 T1 实体所有字段的记录，若存在导航属性则一起查询返回，记录不存在时返回 Count 为 0 的列表 | |
| ToList<Dto> | List<Dto> | Lambda | 执行SQL查询，返回指定字段或Dto映射的记录，记录不存在时返回 Count 为 0 的列表 |
| ToList<T> | List<T> | string field | 执行SQL查询，返回 field 指定字段的记录，并以元组或基础类型(int,string,long)接收，记录不存在时返回 Count 为 0 的列表 |
| ToOne | T1 | 执行SQL查询，返回 T1 实体所有字段的第一条记录，记录不存在时返回 null | |
| ToChunk | <空> | int size, Action<List<T1>> done | 执行SQL查询，分块返回数据，可减少内存开销。比如读取10万条数据，每次返回100条处理。 |
| Any | bool | 执行SQL查询，是否有记录 | |
| Sum | T | Lambda | 指定一个列求和 |
| Min | T | Lambda | 指定一个列求最小值 |
| Max | T | Lambda | 指定一个列求最大值 |
| Avg | T | Lambda | 指定一个列求平均值 |
系列文章导航
（二十一）查询返回数据
