# 查询

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

  • 分页查询
  • 单表查询
  • 多表查询
  • 分组聚合查询
  • 返回数据
  • LinqToSql
  • 仓储层 Repository
  • 过滤器
  • 延时加载
  • 贪婪加载
  • 表达式函数
  • 读写分离
  • 性能
  • 分表分库
  • 多租户

# 特别介绍 WhereDynamicFilter

ISelect.WhereDynamicFilter 方法实现动态过滤条件(与前端交互),支持的操作符:

  • Contains/StartsWith/EndsWith/NotContains/NotStartsWith/NotEndsWith:包含/不包含,like '%xx%',或者 like 'xx%',或者 like '%xx'
  • Equal/NotEqual:等于/不等于
  • GreaterThan/GreaterThanOrEqual:大于/大于等于
  • LessThan/LessThanOrEqual:小于/小于等于
  • Range:范围查询
  • DateRange:日期范围,有特殊处理 value[1] + 1
  • Any/NotAny:是否符合 value 中任何一项(直白的说是 SQL IN)
DynamicFilterInfo dyfilter = JsonConvert.DeserializeObject<DynamicFilterInfo>(@"
{
  ""Logic"" : ""Or"",
  ""Filters"" :
  [
    {
      ""Field"" : ""Code"",
      ""Operator"" : ""NotContains"",
      ""Value"" : ""val1"",
      ""Filters"" :
      [
        {
          ""Field"" : ""Name"",
          ""Operator"" : ""NotStartsWith"",
          ""Value"" : ""val2"",
        }
      ]
    },
    {
      ""Field"" : ""Parent.Code"",
      ""Operator"" : ""Equals"",
      ""Value"" : ""val11"",
      ""Filters"" :
      [
        {
          ""Field"" : ""Parent.Name"",
          ""Operator"" : ""Contains"",
          ""Value"" : ""val22"",
        }
      ]
    }
  ]
}
");
fsql.Select<VM_District_Parent>().WhereDynamicFilter(dyfilter).ToList();
//SELECT a.""Code"", a.""Name"", a.""ParentCode"", a__Parent.""Code"" as4, a__Parent.""Name"" as5, a__Parent.""ParentCode"" as6 
//FROM ""D_District"" a 
//LEFT JOIN ""D_District"" a__Parent ON a__Parent.""Code"" = a.""ParentCode"" 
//WHERE (not((a.""Code"") LIKE '%val1%') AND not((a.""Name"") LIKE 'val2%') OR a__Parent.""Code"" = 'val11' AND (a__Parent.""Name"") LIKE '%val22%')
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

动态排序:ISelect.OrderByPropertyName("Parent.Code")

# API

方法返回值参数描述
ToSqlstring返回即将执行的SQL语句
ToListList<T1>执行SQL查询,返回 T1 实体所有字段的记录,若存在导航属性则一起查询返回,记录不存在时返回 Count 为 0 的列表
ToList<T>List<T>Lambda执行SQL查询,返回指定字段的记录,记录不存在时返回 Count 为 0 的列表
ToList<T>List<T>string field执行SQL查询,返回 field 指定字段的记录,并以元组或基础类型(int,string,long)接收,记录不存在时返回 Count 为 0 的列表
ToOneT1执行SQL查询,返回 T1 实体所有字段的第一条记录,记录不存在时返回 null
ToAggregate<T>List<T>Lambda执行SQL查询,返回指定字段的聚合结果(适合不需要 GroupBy 的场景)
Anybool执行SQL查询,是否有记录
SumTLambda指定一个列求和
MinTLambda指定一个列求最小值
MaxTLambda指定一个列求最大值
AvgTLambda指定一个列求平均值
【分页】
Countlong查询的记录数量
Count<this>out long查询的记录数量,以参数out形式返回
Skip<this>int offset查询向后偏移行数
Offset<this>int offset查询向后偏移行数
Limit<this>int limit查询多少条数据
Take<this>int limit查询多少条数据
Page<this>int pageIndex, int pageSize分页
【条件】
Where<this>Lambda支持多表查询表达式,多次使用相当于AND
WhereIf<this>bool, Lambda支持多表查询表达式
Where<this>string, parms原生sql语法条件,Where("id = ?id", new { id = 1 })
WhereIf<this>bool, string, parms原生sql语法条件,WhereIf(true, "id = ?id", new { id = 1 })
WhereCascade<this>Lambda实现多表查询时,向每个表中附加条件
WhereDynamicFilter<this>DynamicFilterInfo动态过滤条件(与前端交互)
【分组】
GroupBy<this>Lambda按选择的列分组,GroupBy(a => a.Name)
GroupBy<this>string, parms按原生sql语法分组,GroupBy("concat(name, ?cc)", new { cc = 1 })
Having<this>string, parms按原生sql语法聚合条件过滤,Having("count(name) = ?cc", new { cc = 1 })
Disdinct<this>.Distinct().ToList(x => x.GroupName) 是对指定字段
【排序】
OrderBy<this>Lambda按列排序,OrderBy(a => a.Time),可多次使用
OrderByDescending<this>Lambda按列倒向排序,OrderByDescending(a => a.Time)
OrderBy<this>string, parms按原生sql语法排序,OrderBy("count(name) + ?cc", new { cc = 1 })
OrderByPropertyNamestring, bool按属性名字符串排序(支持导航属性)
【联表】
LeftJoin<this>Lambda左联查询,可使用导航属性,或指定关联的实体类型
InnerJoin<this>Lambda联接查询,可使用导航属性,或指定关联的实体类型
RightJoin<this>Lambda右联查询,可使用导航属性,或指定关联的实体类型
LeftJoin<this>string, parms左联查询,使用原生sql语法,LeftJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
InnerJoin<this>string, parms联接查询,使用原生sql语法,InnerJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
RightJoin<this>string, parms右联查询,使用原生sql语法,RightJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
From<this>Lambda多表查询,3个表以上使用非常方便,目前设计最大支持10个表
【其他】
As<this>string alias = "a"指定别名
Master<this>指定从主库查询(默认查询从库)
CommandTimeout<this>int命令超时设置(秒)
WithTransaction<this>DbTransaction设置事务对象
WithConnection<this>DbConnection设置连接对象
WithLock<this>EnumSqlServer NoLock 等特有的设置
ForUpdate<this>bool排他更新锁,对不同的数据库已作适配,详细说明见注释
AsQueryableIQueryable将 ISelect 转换为 IQueryable,此方法主要用于扩展,比如:abp IRepository GetAll() 接口方法需要返回 IQueryable 对象。注意:IQueryable 方法污染较为严重,请尽量避免此转换
ToTreeList()List<TEntity>将父子关系的数据以 TreeList 的形式返回
AsTreeCte()ISelect(up, pathSelector, level)递归查询父子关系表