FreeSql学习笔记——1.入门
前言
学习过程中,使用的是.Net 5 WebApi项目,数据库使用的是SQL Server,主要会整理下常用的api,现在就开始吧~
初始化
先选择一个WebCoreApi项目进行创建,创建完项目后就该引入FreeSql了;
首先引入FreeSql,根据官方文档的说法得引入一个FreeSql包和一个数据库驱动,驱动根据项目需要选择,这里用的数据库是SqlService,所以安装FreeSql.Provider.SqlServer;
引入可以选择命令行(工具=》Nuget包管理器=》程序包管理控制台)或者直接在Nuget中搜索FreeSql
这里先引入了FreeSql包以及一个SqlServer的驱动包
1 2 | Install-Package FreeSql Install-Package FreeSql.Provider.SqlServer |

声明
接下来就是在项目种注入FreeSql实例了,注入前别忘了数据库配置连接字符串,官方文档建议以单例声明,而不是每次使用的时候创建,UseAutoSyncStructure()方法的参数作为条件判断是否对比实体与数据库结构之间的变化,以实现自动迁移;
1 2 3 4 5 6 | IFreeSql freeSql = new FreeSqlBuilder() .UseConnectionString(DataType.SqlServer, Configuration.GetConnectionString( "SqlServerConnection" )) .UseAutoSyncStructure(True) .Build(); services.AddSingleton(freeSql); |
至此,FreeSql实例就注好了,Startup.cs文件如下,Swagger是因为创建项目时勾选了OpenApi

注意:这里的IFreeSql是ORM最顶级对象,所有操作都是使用他的方法或属性(官方原文):
1 2 3 4 5 6 7 8 9 10 11 12 | fsql.Select<T>(); //查询 fsql.Insert<T>(); //插入 fsql.Update<T>(); //更新 fsql.Delete<T>(); //删除 fsql.InsertOrUpdate<T>() // 插入或更新 fsql.Transaction(..); //事务 fsql.CodeFirst; //CodeFirst 对象 fsql.DbFirst; //DbFirst 对象 fsql.Ado; //Ado 对象 fsql.Aop; //Aop 对象 fsql.GlobalFilter; //全局过滤器对象 |
这样就注入完成了,下面就能开始使用FreeSql了~~~~~~~~
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 阿里最新开源QwQ-32B,效果媲美deepseek-r1满血版,部署成本又又又降低了!
· 单线程的Redis速度为什么快?
· SQL Server 2025 AI相关能力初探
· AI编程工具终极对决:字节Trae VS Cursor,谁才是开发者新宠?
· 展开说说关于C#中ORM框架的用法!