FreeSql 教程 （十五）查询数据

FreeSql 以 MIT 开源协议托管于 github：https://github.com/2881099/FreeSql

FreeSql在查询数据下足了功能，链式查询语法、多表查询、表达式函数支持得非常到位。

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.MySql, "Data Source=127.0.0.1;Port=3306;User ID=root;Password=root;Initial Catalog=cccddd;Charset=utf8;SslMode=none;Max pool size=10")
    .Build(); //请务必定义成 Singleton 单例模式

[Table(Name = "tb_topic")]
class Topic {
    [Column(IsIdentity = true, IsPrimary = true)]
    public int Id { get; set; }
    public int Clicks { get; set; }
    public string Title { get; set; }
    public DateTime CreateTime { get; set; }
}

查询数据

var sql = fsql.Select()
  .Where(a => a.Id == 10)
  .ToSql();
///SELECT a.`Id`, a.`Clicks`, a.`TestTypeInfoGuid`, a.`Title`, a.`CreateTime` 
//FROM `tb_topic` a 
//WHERE (a.`Id` = 10)

sql = fsql.Select()
  .Where(a => a.Id == 10 && a.Id > 10 || a.Clicks > 100)
  .ToSql();
///SELECT a.`Id`, a.`Clicks`, a.`TestTypeInfoGuid`, a.`Title`, a.`CreateTime` 
//FROM `tb_topic` a 
//WHERE (a.`Id` = 10 AND a.`Id` > 10 OR a.`Clicks` > 100)

sql = fsql.Select()
  .Where(a => new []{1,2,3}.Contains(a.Id))
  .ToSql();
//SELECT a.`Id`, a.`Clicks`, a.`TestTypeInfoGuid`, a.`Title`, a.`CreateTime` 
//FROM `tb_topic` a 
//WHERE (a.`Id` in (1,2,3))

巧用AsTable

var sql = fsql.Select()
  .AsTable((a, b) => "(select * from user where clicks > 10)")
  .Page(1, 10)
  .ToList()

v1.0.1 ISelect 增加 WithSql("select * from user ...") 功能快速代理此方法

API

方法	返回值	参数	描述
ToSql	string		返回即将执行的SQL语句
ToList	List		执行SQL查询，返回 T1 实体所有字段的记录，若存在导航属性则一起查询返回，记录不存在时返回 Count 为 0 的列表
ToList	List	Lambda	执行SQL查询，返回指定字段的记录，记录不存在时返回 Count 为 0 的列表
ToList	List	string field	执行SQL查询，返回 field 指定字段的记录，并以元组或基础类型(int,string,long)接收，记录不存在时返回 Count 为 0 的列表
ToOne	T1		执行SQL查询，返回 T1 实体所有字段的第一条记录，记录不存在时返回 null
Any	bool		执行SQL查询，是否有记录
Sum	T	Lambda	指定一个列求和
Min	T	Lambda	指定一个列求最小值
Max	T	Lambda	指定一个列求最大值
Avg	T	Lambda	指定一个列求平均值
【分页】
Count	long		查询的记录数量
Count		out long	查询的记录数量，以参数out形式返回
Skip		int offset	查询向后偏移行数
Offset		int offset	查询向后偏移行数
Limit		int limit	查询多少条数据
Take		int limit	查询多少条数据
Page		int pageIndex, int pageSize	分页
【条件】
Where		Lambda	支持多表查询表达式
WhereIf		bool, Lambda	支持多表查询表达式
Where		string, parms	原生sql语法条件，Where("id = ?id", new { id = 1 })
WhereIf		bool, string, parms	原生sql语法条件，WhereIf(true, "id = ?id", new { id = 1 })
WhereCascade		Lambda	实现多表查询时，向每个表中附加条件
【分组】
GroupBy		Lambda	按选择的列分组，GroupBy(a => a.Name)	GroupBy(a => new{a.Name,a.Time})
GroupBy		string, parms	按原生sql语法分组，GroupBy("concat(name, ?cc)", new { cc = 1 })
Having		string, parms	按原生sql语法聚合条件过滤，Having("count(name) = ?cc", new { cc = 1 })
Disdinct			.Distinct().ToList(x => x.GroupName) 是对指定字段
【排序】
OrderBy		Lambda	按列排序，OrderBy(a => a.Time)
OrderByDescending		Lambda	按列倒向排序，OrderByDescending(a => a.Time)
OrderBy		string, parms	按原生sql语法排序，OrderBy("count(name) + ?cc", new { cc = 1 })
【联表】
LeftJoin		Lambda	左联查询，可使用导航属性，或指定关联的实体类型
InnerJoin		Lambda	联接查询，可使用导航属性，或指定关联的实体类型
RightJoin		Lambda	右联查询，可使用导航属性，或指定关联的实体类型
LeftJoin		string, parms	左联查询，使用原生sql语法，LeftJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
InnerJoin		string, parms	联接查询，使用原生sql语法，InnerJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
RightJoin		string, parms	右联查询，使用原生sql语法，RightJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
From		Lambda	多表查询，3个表以上使用非常方便，目前设计最大支持10个表
【其他】
As		string alias = "a"	指定别名
Master			指定从主库查询（默认查询从库）
WithTransaction		DbTransaction	设置事务对象
WithConnection		DbConnection	设置连接对象

系列文章导航

• （一）入门

• （二）自动迁移实体

• （三）实体特性

• （四）实体特性 Fluent Api

• （五）插入数据

• （六）批量插入数据

• （七）插入数据时忽略列

• （八）插入数据时指定列

• （九）删除数据

• （十）更新数据

• （十一）更新数据 Where

• （十二）更新数据时指定列

• （十三）更新数据时忽略列

• （十四）批量更新数据

• （十五）查询数据

• （十六）分页查询

• （十七）联表查询

• （十八）导航属性

• （十九）多表查询

• （二十）多表查询 WhereCascade

• （二十一）查询返回数据

• （二十二）Dto 映射查询

• （二十三）分组、聚合

• （二十四）Linq To Sql 语法使用介绍

• （二十五）延时加载

• （二十六）贪婪加载 Include、IncludeMany、Dto、ToList

• （二十七）将已写好的 SQL 语句，与实体类映射进行二次查询

• （二十八）事务

• （二十九）Lambda 表达式

• （三十）读写分离

• （三十一）分区分表

• （三十二）Aop

• （三十三）CodeFirst 类型映射

• （三十四）CodeFirst 迁移说明

• （三十五）CodeFirst 自定义特性