.NET 7 EF Core Code First：如何拆分多属性实体类？

针对你要将实体类中分散的配置属性封装到嵌套类的需求，EF Core的**拥有实体（Owned Entity Types）**是最贴合的解决方案——它专门用于将一组紧密关联的属性封装为值对象，无需额外创建数据表，直接映射到原表的对应列。

步骤1：定义嵌套的Configuration类 #

把原Annoying类中的ConfigA~ConfigZ属性迁移到独立的Configuration类中：

public class Configuration
{
    public string ConfigA { get; set; }
    // 依次添加其他ConfigX属性
    public string ConfigZ { get; set; }
}

步骤2：重构Annoying实体类 #

在Annoying中添加Configuration类型的属性，并建议初始化避免空引用：

public class Annoying
{
    public string A { get; set; }
    // 保留原有非配置属性
    public string Z { get; set; }

    // 封装后的配置属性，初始化避免空引用
    public Configuration Config { get; set; } = new Configuration();
}

步骤3：配置EF Core映射 #

有两种方式配置拥有实体的映射，推荐使用Fluent API以获得更灵活的控制：

方式一：Fluent API（推荐）

在DbContext的OnModelCreating方法中，指定Annoying拥有Configuration实体，并映射到原表的列名：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Annoying>()
        .OwnsOne(annoying => annoying.Config, configBuilder =>
        {
            // 将Configuration的属性映射回原表的列名
            configBuilder.Property(c => c.ConfigA).HasColumnName("ConfigA");
            // 为每个ConfigX属性添加对应列名映射
            configBuilder.Property(c => c.ConfigZ).HasColumnName("ConfigZ");
        });
}

方式二：数据注解

如果偏好注解方式，可直接在Configuration类上标记[Owned]，并为每个属性指定原列名：

using System.ComponentModel.DataAnnotations.Schema;
using Microsoft.EntityFrameworkCore;

[Owned]
public class Configuration
{
    [Column("ConfigA")]
    public string ConfigA { get; set; }
    // 为每个ConfigX属性添加[Column]注解
    [Column("ConfigZ")]
    public string ConfigZ { get; set; }
}

迁移注意事项 #

生成迁移时，EF Core会识别到属性只是被封装，而非新增/删除列，因此迁移脚本不会修改原表结构（仅更新实体映射元数据）。生成后可检查迁移文件，确保没有不必要的AddColumn或DropColumn操作。

使用方式 #

重构后的数据访问逻辑与原方式兼容，查询和赋值时只需调整属性路径：

// 查询示例
var target = db.Annoyings.FirstOrDefault(a => a.Config.ConfigA == "targetValue");

// 赋值示例
target.Config.ConfigB = "newConfigValue";
db.SaveChanges();

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