C# EF Core值转换器方法 C#如何将自定义类型映射到数据库列-C#.Net教程

EF Core值转换器解决C#类型(如TimeOnly、枚举、JSON、自定义结构体)与数据库列不兼容问题,通过双向无副作用转换实现映射;例如将TimeOnly转TimeSpan存入time列,或Money转decimal存Amount。

EF Core值转换器能解决什么问题

当你的C#模型里有TimeOnly、DateOnly、枚举类、JSON对象(如Dictionary)、或自定义结构体(如Money)时,EF Core默认不支持直接映射到数据库列。值转换器(ValueConverter)就是用来在读写时自动做类型转换的——比如把TimeOnly转成TimeSpan存进time列,或把Money序列化为decimal或nvarchar。

如何注册一个基础的值转换器(以TimeOnly为例)

EF Core 6+原生支持TimeOnly和DateOnly,但如果你用的是老版本,或想自定义行为(比如统一转为datetime2列并忽略日期部分),就得手动配转换器。关键点是:转换必须双向、无副作用、线程安全。

常见做法是在OnModelCreating中为特定属性配置:

modelBuilder.Entity()
    .Property(e => e.ShipTime)
    .HasConversion(
        timeOnly => timeOnly.ToTimeSpan(),           // 写入时:TimeOnly → TimeSpan
        timeSpan => TimeOnly.FromTimeSpan(timeSpan) // 读取时:TimeSpan → TimeOnly
    );

注意:ToTimeSpan()会丢失毫秒精度(TimeOnly支持微秒,TimeSpan在SQL Server time列中只保留到100纳秒)。如果精度敏感,建议用string或long(ticks)做中间类型。

自定义结构体(如Money)怎么映射

假设你有不可变结构体Money,含Amount(decimal)和Currency(string),但只想存Amount到数据库一列(如Price),忽略货币单位:

  • 必须提供无参构造函数或确保EF Core能实例化(否则读取失败)
  • 转换逻辑不能依赖外部状态(比如不能调用DateTime.Now)
  • 推荐用ValueConverter,而非string,避免解析开销

示例:

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » C# EF Core值转换器方法 C#如何将自定义类型映射到数据库列-C#.Net教程
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4000903+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4000903+
  • 本周更新: 0+
  • 最后更新: 2026-03-16