前言
学习过程中,使用的是.Net 5 WebApi项目,数据库使用的是SQL Server,主要会整理下常用的api,现在就开始吧~
初始化
先选择一个WebCoreApi项目进行创建,创建完项目后就该引入FreeSql了;
首先引入FreeSql,根据官方文档的说法得引入一个FreeSql包和一个数据库驱动,驱动根据项目需要选择,这里用的数据库是SqlService,所以安装FreeSql.Provider.SqlServer;
引入可以选择命令行(工具=》Nuget包管理器=》程序包管理控制台)或者直接在Nuget中搜索FreeSql
这里先引入了FreeSql包以及一个SqlServer的驱动包
Install-Package FreeSql Install-Package FreeSql.Provider.SqlServer
声明
接下来就是在项目种注入FreeSql实例了,注入前别忘了数据库配置连接字符串,官方文档建议以单例声明,而不是每次使用的时候创建,UseAutoSyncStructure()方法的参数作为条件判断是否对比实体与数据库结构之间的变化,以实现自动迁移;
IFreeSql freeSql = new FreeSqlBuilder() .UseConnectionString(DataType.SqlServer, Configuration.GetConnectionString("SqlServerConnection")) .UseAutoSyncStructure(True) .Build(); services.AddSingleton(freeSql);
至此,FreeSql实例就注好了,Startup.cs文件如下,Swagger是因为创建项目时勾选了OpenApi
注意:这里的IFreeSql是ORM最顶级对象,所有操作都是使用他的方法或属性(官方原文):
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了~~~~~~~~