FreeSql学习笔记——1.入门


前言

  学习过程中,使用的是.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(); //查询
fsql.Insert(); //插入
fsql.Update(); //更新
fsql.Delete(); //删除
fsql.InsertOrUpdate()// 插入或更新
fsql.Transaction(..); //事务

fsql.CodeFirst; //CodeFirst 对象
fsql.DbFirst; //DbFirst 对象
fsql.Ado; //Ado 对象
fsql.Aop; //Aop 对象
fsql.GlobalFilter; //全局过滤器对象

这样就注入完成了,下面就能开始使用FreeSql了~~~~~~~~

     
ORM