类别：学习文档
日期：2021-07-15 浏览：1918 评论：0
FreeSql是功能强大的 .NET ORM，支持 .NetFramework 4.0+、.NetCore 2.1+、Xamarin 等支持 NetStandard 所有运行平台。
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 单例模式
class Topic {
[Column(IsIdentity = true)]
public int Id { get; set; }
public string Title { get; set; }
public int Clicks { get; set; }
public DateTime CreateTime { get; set; }
public int CategoryId { get; set; }
}每页20条数据，查询第1页
var list = fsql.Select<Topic>() .Where(a => a.Id > 10) .Count(out var total) //总记录数量 .Page(1, 20) .Tolist();
优化
SqlServer 2012 以前的版本，使用 row_number 分页；
SqlServer 2012+ 版本，使用最新的 fetch next rows 分页；
Take/Limit
返回前10条记录：select.Take(10).ToList();
Offset/Skip
跳过前10条记录，返回记录：select.Offset(10).ToList();
API
| 方法 | 返回值 | 参数 | 描述 |
|---|---|---|---|
| ToSql | string | 返回即将执行的SQL语句 | |
| ToList | List | 执行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 的列表 |
| 【分页】 | |||
| Count | long | 查询的记录数量 | |
| 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 | 分页 |
系列文章导航
FreeSql （一）入门及安装 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二）自动迁移实体 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三）实体特性 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （四）实体特性 Fluent Api - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （五）插入数据 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （六）批量插入数据 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （七）插入数据时忽略列 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （八）插入数据时指定列 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （九）删除数据 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十）更新数据 - 学习文档 - 零一的世界 (vtzw.com)FreeSql （十一）更新数据 Where - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十二）更新数据时指定列 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十三）更新数据时忽略列 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十四）批量更新数据 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十五）查询数据 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十六）分页查询 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十七）联表查询 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十八）导航属性 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （十九）多表查询 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十）多表查询 WhereCascade - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十一）查询返回数据 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十二）Dto 映射查询 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十三）分组、聚合 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十四）Linq To Sql 语法使用介绍 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十五）延时加载 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十六）贪婪加载 Include、IncludeMany - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十七）将已写好的 SQL 语句，与实体类映射进行二次查询 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十八）事务 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （二十九）Lambda 表达式 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十）读写分离 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十一）分表分库 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十二）Aop - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十三）CodeFirst 类型映射 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十四）CodeFirst 迁移说明 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十五）CodeFirst 自定义特性 - 学习文档 - 零一的世界 (vtzw.com)
FreeSql （三十六）进阶 仓储系列文档 - 学习文档 - 零一的世界 (vtzw.com)
您阅读本篇文章共花了： 
发表评论 / 取消回复