FreeSql 教程 （三十三）CodeFirst 类型映射

FreeSql 以 MIT 开源协议托管于 github：https://github.com/2881099/FreeSql

前面有介绍过几篇 CodeFirst 内容文章，有

• 《（二）自动迁移实体》(https://www.cnblogs.com/FreeSql/p/11531301.html)
• 《（三）实体特性》(https://www.cnblogs.com/FreeSql/p/11531302.html)
• 《（四）实体特性 Fluent Api》(https://www.cnblogs.com/FreeSql/p/11531304.html)
• 《（十八）导航属性》(https://www.cnblogs.com/FreeSql/p/11531352.html)

入门 FreeSql 前这些算是基础教程，需要提前了解，接下来进入 CodeFirst 功能的深入了解。

类型映射是 ORM 最重要的功能之一，FreeSql 支持五大数据库大多数数据库类型，包括 mysql 的 enum/set，pgsql 的 hstore/jsonb 等等。。除此默认之外，还提供了自定义类型映射。

类型映射，需要考虑写入（我们的写入需要考虑 NoneParameter 和 Parameter）、读取时的转换工作，这部分扩展对个人使用者而言比较复杂，如有需要请提出您的 issues。

FreeSql 拥有较高容错处理，如：当数据库类型为 bigint 可空，实体类为 int 时，读取数据不会出错。

自定义类型映射(MapType)

class EnumTestMap {
    public Guid id { get; set; }

    [Column(MapType = typeof(string))]
    public ToStringMapEnum enum_to_string { get; set; }
    [Column(MapType = typeof(string))]
    public ToStringMapEnum? enumnullable_to_string { get; set; }

    [Column(MapType = typeof(int))]
    public ToStringMapEnum enum_to_int { get; set; }
    [Column(MapType = typeof(int?))]
    public ToStringMapEnum? enumnullable_to_int { get; set; }

    [Column(MapType = typeof(string))]
    public BigInteger biginteger_to_string { get; set; }
    [Column(MapType = typeof(string))]
    public BigInteger? bigintegernullable_to_string { get; set; }
}
public enum ToStringMapEnum { 中国人, abc, 香港 }

应该不需要解释了吧？

BigInteger 都可以映射使用了，但请注意：仅仅是 CURD 方便， Equals == 判断可以使用，无法实现 + - * / 等操作；

FreeSql.Extensions.JsonMap

上面的 MapType 只能处理有限的类型，JsonMap 是一个扩展包，实现属性对象映射为 varchar 字段，写入时使用 json.net 序列化，读取时使用 json.net 反序列化。

安装扩展包：

dotnet add package FreeSql.Extensions.JsonMap

fsql.UseJsonMap(); //开启功能, fsql 为 IFreeSql 对象

class TestConfig
{
    public int clicks { get; set; }
    public string title { get; set; }
}
[Table(Name = "sysconfig")]
public class S_SysConfig<T>
{
    [Column(IsPrimary = true)]
    public string Name { get; set; }

    [JsonMap]
    public T Config { get; set; }
}

默认类型映射

string 指定长度 [Column(DbType = "varchar(max)")] 或者 [MaxLength(-1)] 或者 [Column(StringLength = -1)]，当长度 -1 时产生的映射如下：

系列文章导航

• （一）入门

• （二）自动迁移实体

• （三）实体特性

• （四）实体特性 Fluent Api

• （五）插入数据

• （六）批量插入数据

• （七）插入数据时忽略列

• （八）插入数据时指定列

• （九）删除数据

• （十）更新数据

• （十一）更新数据 Where

• （十二）更新数据时指定列

• （十三）更新数据时忽略列

• （十四）批量更新数据

• （十五）查询数据

• （十六）分页查询

• （十七）联表查询

• （十八）导航属性

• （十九）多表查询

• （二十）多表查询 WhereCascade

• （二十一）查询返回数据

• （二十二）Dto 映射查询

• （二十三）分组、聚合

• （二十四）Linq To Sql 语法使用介绍

• （二十五）延时加载

• （二十六）贪婪加载 Include、IncludeMany、Dto、ToList

• （二十七）将已写好的 SQL 语句，与实体类映射进行二次查询

• （二十八）事务

• （二十九）Lambda 表达式

• （三十）读写分离

• （三十一）分区分表

• （三十二）Aop

• （三十三）CodeFirst 类型映射

• （三十四）CodeFirst 迁移说明

• （三十五）CodeFirst 自定义特性