如何正确映射带有EnumMember特性的枚举值至Entity Framework实体列？

你遇到的问题根源在于默认的ToString()和Enum.Parse()逻辑是基于枚举的字段名（比如Order），而不是你通过EnumMember特性定义的友好名称（比如Order Based）。当你尝试存入"Order Based"时，Enum.Parse()找不到对应字段名，自然就报错了。

下面是具体的解决方案，核心是自定义转换逻辑，让EF Core使用EnumMember的Value来完成数据库和枚举之间的映射：

1. 编写枚举扩展方法 #

先创建一个静态类，提供两个方法：一个用来获取枚举值对应的EnumMember Value，另一个用来根据Value反向解析枚举：

public static class EnumExtensions
{
    // 获取枚举成员的EnumMember Value
    public static string GetEnumMemberValue<TEnum>(this TEnum enumValue) where TEnum : Enum
    {
        var memberInfo = typeof(TEnum).GetMember(enumValue.ToString()).FirstOrDefault();
        var enumMemberAttr = memberInfo?.GetCustomAttribute<EnumMemberAttribute>();
        // 如果没有EnumMember特性， fallback到默认字段名
        return enumMemberAttr?.Value ?? enumValue.ToString();
    }

    // 根据EnumMember Value解析枚举
    public static TEnum ParseEnumFromMemberValue<TEnum>(string value) where TEnum : Enum
    {
        foreach (var field in typeof(TEnum).GetFields())
        {
            var enumMemberAttr = field.GetCustomAttribute<EnumMemberAttribute>();
            if (enumMemberAttr != null && enumMemberAttr.Value.Equals(value, StringComparison.OrdinalIgnoreCase))
            {
                return (TEnum)field.GetValue(null);
            }
        }
        // 没找到时，尝试常规解析，或者根据需求抛出异常
        return (TEnum)Enum.Parse(typeof(TEnum), value);
    }
}

2. 配置EF Core的属性转换 #

在你的DbContext配置中，替换原来的转换逻辑，使用上面的扩展方法：

modelBuilder.Entity<FormBasisDto>()
    .Property(formBasis => formBasis.Name)
    .HasConversion(
        // 保存到数据库时：枚举值 → EnumMember Value
        fb => fb.GetEnumMemberValue(),
        // 从数据库读取时：EnumMember Value → 枚举值
        fb => EnumExtensions.ParseEnumFromMemberValue<CM.FormBasis>(fb)
    )
    .HasMaxLength(50); // 和数据库字段的varchar(50)对应

3. 可选：封装成ValueConverter类 #

如果多个枚举都需要这种映射，可以把转换逻辑封装成通用的ValueConverter，复用性更强：

public class EnumMemberValueConverter<TEnum> : ValueConverter<TEnum, string> where TEnum : Enum
{
    public EnumMemberValueConverter() : base(
        v => v.GetEnumMemberValue(),
        v => EnumExtensions.ParseEnumFromMemberValue<TEnum>(v)
    )
    {
    }
}

然后配置时可以简化成：

modelBuilder.Entity<FormBasisDto>()
    .Property(formBasis => formBasis.Name)
    .HasConversion<EnumMemberValueConverter<CM.FormBasis>>()
    .HasMaxLength(50);

这样配置后，当你保存FormBasis.Order时，数据库里会存入"Order Based"；读取时，也能正确把"Order Based"转回FormBasis.Order，不会再出现找不到值的错误。

内容的提问来源于stack exchange，提问作者CBC_NS