FreeSql （一）入门

时间 2019-11-05

标签 freesql 入门繁體版

原文原文链接

FreeSql 是一个功能强大的对象关系映射程序(O/RM)，支持 .NETCore 2.1+ 或 .NETFramework 4.5+（QQ群：4336577）html

FreeSql采用MIT开源协议托管于 github。git

特性

[x] 支持 CodeFirst 迁移；
[x] 支持 DbFirst 从数据库导入实体类，支持三种模板生成器；
[x] 采用 ExpressionTree 高性能读取数据；
[x] 支持深刻的类型映射，好比pgsql的数组类型，堪称匠心制做；
[x] 支持丰富的表达式函数；
[x] 支持导航属性查询，和延时加载；
[x] 支持同步/异步数据库操做方法，丰富多彩的链式查询方法；
[x] 支持读写分离、分表分库，租户设计；
[x] 支持多种数据库，MySql/SqlServer/PostgreSQL/Oracle/Sqlite；

模型

使用模型执行数据访问，模型由实体类表示数据库表或视图，用于查询和保存数据。github

可从现有数据库生成实体模型，FreeSql 提供 IDbFirst 接口实现生生成实体模型。sql

或者手动建立模型，基于模型建立或修改数据库，提供 ICodeFirst 同步结构的 API（甚至能够作到开发阶段自动同步）。数据库

using FreeSql.DataAnnotations;
using System;

public class Blog
{
    [Column(IsIdentity = true, IsPrimary = true)]
    public int BlogId { get; set; }
    public string Url { get; set; }
    public int Rating { get; set; }
}

声明

dotnet add packages FreeSql.Provider.Sqlite数组

var connstr = @"Data Source=|DataDirectory|\db1.db;Attachs=db2.db;Pooling=true;Max Pool Size=10";

IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.Sqlite, connstr)
    .UseAutoSyncStructure(true) //自动同步实体结构到数据库
    .Build();

注意： IFreeSql 在项目中应以单例声明，而不是在每次使用的时候建立。异步

迁移

程序运行中FreeSql会检查AutoSyncStructure参数，以此条件判断是否对比实体与数据库结构之间的变化，达到自动迁移的目的。ide

查询

var blogs = fsql.Select<Blog>()
    .Where(b => b.Rating > 3)
    .OrderBy(b => b.Url)
    .Skip(100)
    .Limit(10) //第100行-110行的记录
    .ToList();

插入

var blog = new Blog { Url = "http://sample.com" };
blog.BlogId = (int)fsql.Insert<Blog>()
    .AppendData(blog)
    .ExecuteIdentity();

更新

fsql.Update<Blog>()
    .Set(b => b.Url, "http://sample2222.com")
    .Where(b => b.Url == "http://sample.com")
    .ExecuteAffrows();

删除

fsql.Delete<Blog>()
    .Where(b => b.Url == "http://sample.com")
    .ExecuteAffrows();

FreeSql （一）入门

特性

模型

声明

迁移

查询

插入

更新

删除

系列文章导航