Skip to content

DbFirst

2881099 edited this page Mar 25, 2023 · 29 revisions

DB First

static IFreeSql fsql = new FreeSql.FreeSqlBuilder() .UseConnectionString(FreeSql.DataType.MySql, connectionString) .Build(); //请务必定义成 Singleton 单例模式

获取所有数据库

var t1 = fsql.DbFirst.GetDatabases(); //返回字符串数组, ["cccddd", "test"]

获取指定数据库的表信息

var t2 = fsql.DbFirst.GetTablesByDatabase(fsql.DbFirst.GetDatabases()[0]); //返回包括表、列详情、主键、唯一键、索引、外键、备注等等 var t3 = fsql.DbFirst.GetTableByName("table1"); //返回表的列详情、主键、唯一键、索引、备注等等

.NET Core CLI(推荐使用)

代码生成器FreeSql.Generator,是FreeSql的代码生成器,可生成实体类,支持将数据库实体动态生成实体,默认有二个模板,基于Razor,可指定自定义模板

  • dotnet-tool安装 FreeSql.Generator
dotnet tool install -g FreeSql.Generator 
  • 更新FreeSql.Generator
dotnet tool update -g FreeSql.Generator 

新建目录,在地址栏输入 cmd 快速打开命令窗口,输入命令:

FreeSql.Generator --help 

命令行工具生成实体类极大好处,后续再次生成覆盖操作等于一键完成,并且支持 Mac/Linux 平台。

详细解读:生成器是如何实现的?

C:\WINDOWS\system32>FreeSql.Generator --help ____ ____ __ / __/ ____ ___ ___ / __/ ___ _ / / / _/ / __// -_)/ -_) _\ \ / _ `/ / / /_/ /_/ \__/ \__/ /___/ \_, / /_/ /_/ # Github # https://github.com/2881099/FreeSql v2.0.105 FreeSql 快速生成数据库的实体类 更新工具:dotnet tool update -g FreeSql.Generator # 快速开始 # > FreeSql.Generator -Razor 1 -NameOptions 0,0,0,0 -NameSpace MyProject -DB "MySql,Data Source=127.0.0.1;..." -Razor 1 * 选择模板:实体类+特性 -Razor 2 * 选择模板:实体类+特性+导航属性 -Razor "d:\diy.cshtml" * 自定义模板文件 -NameOptions * 4个布尔值对应: 首字母大写 首字母大写,其他小写 全部小写 下划线转驼峰 -NameSpace * 命名空间 -DB "MySql,data source=127.0.0.1;port=3306;user id=root;password=root;initial catalog=数据库;charset=utf8;sslmode=none;max pool size=2" -DB "SqlServer,data source=.;initial catalog=数据库;User Id=sa;Password=123456;TrustServerCertificate=true;pooling=true;max pool size=2" -DB "PostgreSQL,host=192.168.164.10;port=5432;username=postgres;password=123456;database=数据库;pooling=true;maximum pool size=2" -DB "Oracle,user id=user1;password=123456;data source=//127.0.0.1:1521/XE;pooling=true;max pool size=2" -DB "Sqlite,data source=document.db" -DB "Firebird,database=localhost:D:\fbdata\EXAMPLES.fdb;user=sysdba;password=123456;max pool size=2" -DB "Dameng,server=127.0.0.1;port=5236;user id=2user;password=123456789;database=2user;poolsize=2" -DB "KingbaseES,server=127.0.0.1;port=54321;uid=USER2;pwd=123456789;database=数据库" -DB "ShenTong,host=192.168.164.10;port=2003;database=数据库;username=SYSDBA;password=szoscar55;maxpoolsize=2" * Dameng(达梦数据库)、KingbaseES(人大金仓数据库)、ShenTong(神舟通用数据库) -Filter Table+View+StoreProcedure 默认生成:表+视图+存储过程 如果不想生成视图和存储过程 -Filter View+StoreProcedure -Match 表名或正则表达式,只生成匹配的表,如:dbo\.TB_.+ -FileName 文件名,默认:{name}.cs -Output 保存路径,默认为当前 shell 所在目录 推荐在实体类目录创建 gen.bat,双击它重新所有实体类 

常用选项

选项 说明
-Razor 选择模板:实体类+特性 -Razor 1 / 实体类+特性+导航属性 -Razor 2 / 自定义模板 -Razor "d:\diy.cshtml"
-NameOptions 生成的实体命名规范,应只设置某一个为参数为1,其中4个布尔值对应:首字母大写/首字母大写,其他小写/全部小写/下划线转驼(-NameOptions 0,0,0,1)
-NameSpace 命名空间
-DB 看下文中的-DB参数
-Filter Table+View+StoreProcedure( 默认生成:表+视图+存储过程), 如果不想生成视图和存储过程 -Filter View+StoreProcedure
-Match 表名或正则表达式,只生成匹配的表,如:dbo.TB_.+
-FileName 文件名,默认:{name}.cs
-Output 推荐在实体类目录创建 gen.bat,双击它重新所有实体类

-DB参数

  • 语法
-DB "[数据库类型],[数据库连接串]" 
  • 参考
-DB "MySql,Data Source=127.0.0.1;Port=3306;User ID=root;Password=123456;Initial Catalog=lincms;Charset=utf8;SslMode=none;Max pool size=2" 

示例

FreeSql.Generator -Razor 1 -NameOptions 0,0,0,1 -NameSpace LinCms.Core.Entities -DB "MySql,Data Source=127.0.0.1;Port=3306;User ID=root;Password=123456;Initial Catalog=lincms;Charset=utf8;SslMode=none;Max pool size=2"

  • 数据库表名是下划线,字段也是下划线方式。
  • -Razor 指定 第一个模板
  • -NameOptions 0,0,0,1 最后一个1,代表 下划线转驼峰,满足C#命名规则
  • -NameSpace 指定了命名空间 LinCms.Core.Entities
  • -DB 就是数据库的相关配置
  • mysql 本地地址 127.0.0.1 3306端口 用户名 root 密码123456 数据库 lin-cms
  • -Match book 这样就能只生成book,支持正则表达式,如 -Math lin_user 就会生成以lin_user开头的表。如dbo.TB_.+,会生成以TB开头的表。即只生成匹配的表

安装 Winform 生成器(已停止更新)

源码地址:FreeSql.Tools

作者:mypeng1985 开发了两个版本

image

image

参考资料

Clone this wiki locally