EF Core值转换器怎么用 EF Core Value Converters教程

EF Core值转换器是自动类型转换工具，用于实体与数据库间无缝转换枚举、JSON、TimeSpan等类型；支持匿名函数或自定义类配置，推荐优先使用内置转换器并注意null处理、序列化选项及字段类型匹配。

EF Core 值转换器（Value Converters）本质是“自动翻译官”——它在实体属性值写入数据库前、或从数据库读出后，悄悄做一次类型转换，业务代码完全不用感知。用对了，能省掉大量手动序列化/解析逻辑，还能让数据库字段更友好（比如存枚举为字符串、存对象为 JSON）。

什么时候该用值转换器？

常见场景包括：

• 把 enum 存成字符串（避免数据库里全是 0/1/2，难懂又难查）
• 把 List 或复杂对象序列化为 JSON 字符串（尤其适合轻量级配置、标签、地址等非关系型结构）
• 把 TimeSpan 转成 long（Ticks） 存整数，规避 SQL Server 对 TimeSpan 的精度限制
• 把 IPAddress、DateTimeOffset、Guid 等类型转成可存储的字符串或数字
• 做简单脱敏，比如 手机号入库前加密、读出后解密（注意：敏感操作建议用数据库层加密或专用安全库）

两种配置方式：一行代码 or 可复用类

推荐按使用频率选：

• 临时用、只配一次 → 直接在 OnModelCreating 里用 .HasConversion() 匿名函数
• 多处用、要测试、需统一行为 → 封装成继承 ValueConverter 的类

例如，给枚举配字符串转换：

modelBuilder.Entity()
  .Property(e => e.Status)
  .HasConversion(v => v.ToString(), v => Enum.Parse(v));

public class OrderStatusConverter : ValueConverter
{
  public OrderStatusConverter() : base(
    v => v.ToString(),
    v => (OrderStatus)Enum.Parse(typeof(OrderStatus), v)) { }
}

Play.ht

根据文本生成多种逼真的语音

下载

然后注册：.HasConversion()

JSON 类型转换要注意什么？

这是高频需求，但容易踩坑：

• 数据库字段类型得是 TEXT（SQLite）、nvarchar(max)（SQL Server）、json（PostgreSQL） 等支持长文本的类型
• 别用 JsonSerializerOptions.Default 直接传参——它默认忽略 null，可能丢失字段；建议显式配置：new JsonSerializerOptions { PropertyNamingPolicy = JsonNamingPolicy.CamelCase, DefaultIgnoreCondition = JsonIgnoreCondition.Never }
• 反序列化时若 JSON 格式错误，会抛 JsonException，EF Core 不捕获——务必确保数据干净，或加一层 try/catch 包装（放在自定义转换器内部）
• 不要对大对象（如 >1MB）频繁用 JSON 转换，性能和可维护性都会下降

内置转换器够用吗？

EF Core 提供了一批开箱即用的转换器，比如：

• BoolToStringConverter（true → "True"）
• BytesToStringConverter（byte[] → Base64 字符串）
• CharToStringConverter（char → "A"）
• EnumToStringConverter（比手写 ToString 更安全）

它们都位于 Microsoft.EntityFrameworkCore.Storage.ValueConversion 命名空间。如果只是基础映射，优先用内置的，稳定且经过充分测试。

基本上就这些。值转换器不复杂，但容易忽略 null 处理、序列化选项、数据库字段类型匹配这些细节。配好之后，你的实体保持干净，数据库也更语义化。