FreeSql 以 MIT 开源协议托管于 github：https://github.com/2881099/FreeSql
1、Dto 映射查询
Select<Tag>().Limit(10).ToList(a => new TestDto());
Select<Tag>().Limit(10).ToList(a => new TestDto { });
Select<Tag>().Limit(10).ToList(a => new TestDto() { });
Select<Tag>().Limit(10).ToList<TestDto>();
Select<Tag>().Limit(10).ToList(a => new TestDto { id = a.Id, name = a.Title });
//相当于先映射 TestDto，再映射 a.Id, a.Title
//注意：v0.11.6 以前的版本是只映射 a.Id, a.Title
//注意：v0.11.20 如果 new 本实体，则不附加所有字段
fsql.Select<Song>().ToList(a => new DTO { xxx = a.ext })
//情况1：附加所有映射，再额外映射 ext，返回 List<DTO>
fsql.Select<Song>().ToList(a => new Song { id = a.id })
//情况2：只查询 id，返回 List<Song>
fsql.Select<Song>().ToList(a => new { id = a.id })
//情况3：只查询 id，返回 List<匿名对象>
fsql.Select<Song>().ToList(a => new DTO(a.id))
//情况4：只查询 id，返回 List<DTO>
fsql.Select<Song>().ToList(a => new DTO(a.id) { xxx = a.ext })
//情况5：查询 id, ext，返回 List<DTO>
fsql.Select<Song>().ToList(a => new Song(a.id))
//情况6：查询 id，返回 List<Song>
fsql.Select<Song>().ToList(a => new Song(a.id) { xxx = a.ext })
//情况7：查询 id, ext，返回 List<Song>
这种映射支持单表/多表，在查询数据之前映射（不是先查询所有字段再到内存映射）
查找规则，查找属性名，会循环内部对象 _tables（join 查询后会增长），以 主表优先查，直到查到相同的字段。
如：
A, B, C 都有 id，Dto { id, a1, a2, b1, b2 }，A.id 被映射。也可以指定 id = C.id 映射。
友情提醒：在 dto 可以直接映射一个导航属性
2、导航属性 ManyToOne/OneToOne
ManyToOne/OneToOne 导航属性通过 ToList() 加载，这个方法有一个参数：includeNestedMembers。
参数说明：
false: 返回 2级 Join 的数据；
true: 返回所有层级深度 Join 的导航数据；
如果查询中已经使用了 a.Parent.Parent 类似表达式，则可以无需 LeftJoin 等操作。
如：
Select<Tag>().Where(a => a.Parent.Name == "1").ToList();
//这样写，不需要再标记 Join，解析表达式时自动处理成 LeftJoin
如果导航属性没有使用，又想加载，可使用 Include 方法。
Select<Tag>().Include(a => a.Parent).ToList();
3、导航属性 OneToMany/ManyToMany
IncludeMany 贪婪加载集合的导航属性，其实是分两次查询，在 ToList 后进行了数据重装。
Select<Tag>().IncludeMany(a => a.Songs).ToList();
//这是 ManyToMany 关系的贪婪加载
OneToMany 的使用方法相同
IncludeMany 有第二个参数，可以进行二次查询前的修饰工作。
Select<Tag>().IncludeMany(a => a.Songs,
then => then.Where(song => song.User == "admin")).ToList();
然后，其实在 then 那里，还可以继续进行向下 Include/IncludeMany。只要你喜欢，向下 100 层都没问题。
4、变异
变异的 IncludeMany，即使选择的不是导航属性，也可以贪婪加载。
Select<Tag>().IncludeMany(a => a.TestManys.Where(b => b.TagId == a.Id));
支持联合键关系指定
只查询每项子集合的前几条数据，避免像EfCore加载所有数据导致IO性能低下（比如某商品下有2000条评论）。
Select<Tag>().IncludeMany(a => a.TestManys.Take(10));
设置子集合返回部分字段，避免子集合字段过多的问题。
Select<Tag>().IncludeMany(a => a.TestManys.Select(b => new TestMany { Title = b.Title ... }));
5、IncludeMany 扩展方法
前面介绍 ISelect 中进行贪婪加载集合属性数据，主数据与子数据查询必须在一个代码逻辑内完成。
当主数据已存在内存中，子数据怎么加载？所以我们增加了 List<T> 扩展方法，示例如下：
new List<Song>(new[] { song1, song2, song3 }).IncludeMany(fsql, a => a.Tags);
这是一个扩展方法（IncludeMany），方法名与 ISelect.IncludeMany 同名，参数基本一致（除了需要额外传递 IFreeSql 对象参数），功能也一致（包括前面提到的变异）。
系列文章导航
-
（二十六）贪婪加载 Include、IncludeMany、Dto、ToList
网友评论