前面有介紹過幾篇 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; }
}默認類型映射
| csharp | MySql | SqlServer | PostgreSQL | Oracle | Sqlite |
|---|---|---|---|---|---|
| bool | bool? | bit(1) | bit | bool | number(1) | boolean |
| sbyte | sbyte? | tinyint(3) | smallint | int2 | number(4) | smallint |
| short | short? | smallint(6) | smallint | int2 | number(6) | smallint |
| int | int? | int(11) | int | int4 | number(11) | integer |
| long | long? | bigint(20) | bigint | int8 | number(21) | integer |
| byte | byte? | tinyint(3) unsigned | tinyint | int2 | number(3) | int2 |
| ushort | ushort? | smallint(5) unsigned | int | int4 | number(5) | unsigned |
| uint | uint? | int(10) unsigned | bigint | int8 | number(10) | decimal(10,0) |
| ulong | ulong? | bigint(20) unsigned | decimal(20,0) | numeric(20,0) | number(20) | decimal(21,0) |
| double | double? | double | float | float8 | float(126) | double |
| float | float? | float | real | float4 | float(63) | float |
| decimal | decimal? | decimal(10,2) | decimal(10,2) | numeric(10,2) | number(10,2) | decimal(10,2) |
| Guid | Guid? | char(36) | uniqueidentifier | uuid | char(36 CHAR) | character(36) |
| TimeSpan | TimeSpan? | time | time | time | interval day(2) to second(6) | bigint |
| DateTime | DateTime? | datetime | datetime | timestamp | timestamp(6) | datetime |
| DateTimeOffset | DateTimeOffset? | - | - | datetimeoffset | timestamp(6) with local time zone | - |
| Enum | Enum? | enum | int | int4 | number(16) | mediumint |
| FlagsEnum | FlagsEnum? | set | bigint | int8 | number(32) | bigint |
| byte[] | varbinary(255) | varbinary(255) | bytea | blob | blob |
| string | varchar(255) | nvarchar(255) | varchar(255) | nvarchar2(255) | nvarchar(255) |
| MygisPoint | point | - | - | - | - |
| MygisLineString | linestring | - | - | - | - |
| MygisPolygon | polygon | - | - | - | - |
| MygisMultiPoint | multipoint | - | - | - | - |
| MygisMultiLineString | multilinestring | - | - | - | - |
| MygisMultiPolygon | multipolygon | - | - | - | - |
| BitArray | - | - | varbit(64) | - | - |
| NpgsqlPoint | NpgsqlPoint? | - | - | point | - | - |
| NpgsqlLine | NpgsqlLine? | - | - | line | - | - |
| NpgsqlLSeg | NpgsqlLSeg? | - | - | lseg | - | - |
| NpgsqlBox | NpgsqlBox? | - | - | box | - | - |
| NpgsqlPath | NpgsqlPath? | - | - | path | - | - |
| NpgsqlPolygon | NpgsqlPolygon? | - | - | polygon | - | - |
| NpgsqlCircle | NpgsqlCircle? | - | - | circle | - | - |
| (IPAddress Address, int Subnet) | (IPAddress Address, int Subnet)? | - | - | cidr | - | - |
| IPAddress | - | - | inet | - | - |
| PhysicalAddress | - | - | macaddr | - | - |
| NpgsqlRange<int> | NpgsqlRange<int>? | - | - | int4range | - | - |
| NpgsqlRange<long> | NpgsqlRange<long>? | - | - | int8range | - | - |
| NpgsqlRange<decimal> | NpgsqlRange<decimal>? | - | - | numrange | - | - |
| NpgsqlRange<DateTime> | NpgsqlRange<DateTime>? | - | - | tsrange | - | - |
| PostgisPoint | - | - | geometry | - | - |
| PostgisLineString | - | - | geometry | - | - |
| PostgisPolygon | - | - | geometry | - | - |
| PostgisMultiPoint | - | - | geometry | - | - |
| PostgisMultiLineString | - | - | geometry | - | - |
| PostgisMultiPolygon | - | - | geometry | - | - |
| PostgisGeometry | - | - | geometry | - | - |
| PostgisGeometryCollection | - | - | geometry | - | - |
| Dictionary<string, string> | - | - | hstore | - | - |
| JToken | - | - | jsonb | - | - |
| JObject | - | - | jsonb | - | - |
| JArray | - | - | jsonb | - | - |
| 數組 | - | - | 以上所有類型都支持 | - | - |
以上類型和長度是默認值，可手工設置，如 string 屬性可指定 [Column(DbType = "varchar(max)")]
系列文章導航
（一）入門
（二）自動遷移實體
（三）實體特性
（四）實體特性 Fluent Api
（五）插入數據
（六）批量插入數據
（七）插入數據時忽略列
（八）插入數據時指定列
（九）刪除數據
（十）更新數據
（十一）更新數據 Where
（十二）更新數據時指定列
（十三）更新數據時忽略列
（十四）批量更新數據
（十五）查詢數據
（十六）分頁查詢
（十七）聯表查詢
（十八）導航屬性
（十九）多表查詢
（二十）多表查詢 WhereCascade
（二十一）查詢返回數據
（二十二）Dto 映射查詢
（二十三）分組、聚合
（二十四）Linq To Sql 語法使用介紹
（二十五）延時加載
（二十六）貪婪加載 Include、IncludeMany、Dto、ToList
（二十七）將已寫好的 SQL 語句，與實體類映射進行二次查詢
（二十八）事務
（二十九）Lambda 表達式
（三十）讀寫分離
（三十一）分區分表
（三十二）Aop
（三十三）CodeFirst 類型映射
（三十四）CodeFirst 遷移說明
（三十五）CodeFirst 自定義特性
)
