值转换器可在EF Core中实现CLR类型与数据库类型的双向转换,如将枚举转为字符串存储、序列化List为JSON等,通过Fluent API在OnModelCreating中配置,支持内置和自定义转换器,提升模型灵活性与数据库兼容性。

在 C# 中使用 EF Core 的值转换器(Value Converters)可以让你在将数据写入数据库和从数据库读取时,自动转换属性的值。这在实体模型中的类型与数据库列类型不一致时特别有用,比如使用 枚举字符串存储、加密字段、或处理 复杂类型如 List/JSON 等场景。
1. 什么是值转换器?
EF Core 值转换器允许你在 CLR 类型和数据库表示之间进行双向转换。例如:
将 enum 转为字符串存储到数据库将 DateTimeOffset 转为 UTC 时间存储将 List 序列化为 JSON 字符串
转换发生在 EF Core 写入数据库前和读取后,对业务代码透明。
2. 如何配置值转换器?
值转换器可以通过 Fluent API 在 OnModelCreating 方法中配置。以下是常见用法示例:
示例1:使用内置转换器(Enum 转字符串)
假设你有一个用户状态枚举:
public enum UserStatus{ Active, Inactive, Pending}public class User{public int Id { get; set; }public string Name { get; set; }public UserStatus Status { get; set; }}
你想把 Status 以字符串形式存入数据库:
protected override void OnModelCreating(ModelBuilder modelBuilder){ modelBuilder.Entity() .Property(e => e.Status) .HasConversion();}
这样 EF Core 会自动将 Active 存为 “Active” 字符串。
示例2:自定义转换器(List 转 JSON)
如果你想将一个字符串列表序列化为 JSON 存储:
public class Product{ public int Id { get; set; } public string Name { get; set; } public List Tags { get; set; }}
使用 ValueConverter 配置:
protected override void OnModelCreating(ModelBuilder modelBuilder){ modelBuilder.Entity() .Property(e => e.Tags) .HasConversion( v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null), v => JsonSerializer.Deserialize<List>(v, new JsonSerializerOptions()) );}
这样 Tags 会被序列化成 JSON 字符串存入数据库。
示例3:创建可复用的转换器类
对于复杂逻辑,建议封装成类:
public class JsonValueConverter : ValueConverter where T : class, new(){ public JsonValueConverter() : base( v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null), v => JsonSerializer.Deserialize(v, new JsonSerializerOptions()) ?? new T()) { }}
然后在模型中使用:
modelBuilder.Entity() .Property(e => e.Tags) .HasConversion(new JsonValueConverter<List>());
3. 注意事项
转换器只影响数据库读写,不影响内存中的实体操作LINQ 查询中涉及转换字段时,EF Core 需能翻译转换逻辑,否则可能抛异常尽量避免在转换器中做耗时操作(如加解密),会影响性能如果字段用于查询或索引,确保转换后的值适合数据库操作
基本上就这些。值转换器是 EF Core 处理类型映射的灵活方式,合理使用可以让模型设计更贴近业务,同时保持数据库兼容性。配置简单,但功能强大。
以上就是C#中如何使用EF Core的值转换器?如何配置?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1440626.html
微信扫一扫
支付宝扫一扫