概述

在 Entity Framework Core（EF Core）中，实体类不仅可以使用公共属性进行数据库映射，还可以通过配置支持对私有字段的持久化操作。这种机制允许开发者将敏感数据或内部状态封装为私有字段，同时仍能被 EF Core 正确读写。

实体定义：使用私有字段和只读属性

以下示例展示了一个博客（Blog）实体，其中包含两个私有字段：_url 和 soltCode，分别用于存储 URL 值和附加代码。这些字段通过只读属性暴露给外部，但实际的数据持久化由 EF Core 直接操作私有成员完成。

public class Blog
{
    public Blog()
    {
        Posts = new List<Post>();
    }

    public int Id { get; set; }

    // 导航集合：文章列表
    public IEnumerable<Post> Posts { get; set; }

    // 私有字段，仅通过属性读取
    private string _url;
    public string Url => _url;

    // 纯私有字段，无对应公共属性
    private string soltCode;
}

public class Post
{
    public int Id { get; set; }
    public int BlogId { get; set; }
    public Blog? Blog { get; set; }
}

配置私有字段映射

为了使 EF Core 能够识别并操作上述私有字段，需在 IEntityTypeConfiguration<T> 配置中显式指定字段名称及访问策略。

1. 映射属性到私有字段

使用 HasField("_fieldName") 指定属性应映射到哪个私有字段：

builder.Property(x => x.Url).HasField("_url");

2. 强制使用字段访问模式

默认情况下，EF Core 优先使用属性 setter 进行赋值。若希望跳过属性逻辑、直接写入字段（例如避免副作用），可设置访问模式为 Field：

builder.Property(x => x.Url)
    .HasField("_url")
    .UsePropertyAccessMode(PropertyAccessMode.Field);

此配置确保无论是查询加载还是变更跟踪，EF Core 都会直接读写 _url 字段，而不调用属性访问器。

3. 映射无公共属性的私有字段

对于完全私有的字段（如 soltCode），可通过字符串形式注册其映射关系：

builder.Property("soltCode").HasColumnName("SoltCode");

该方式告诉 EF Core 在数据库表中创建名为 SoltCode 的列，并将其绑定到实体中的同名私有字段。

关系配置示例

本例中，Blog 与 Post 构成一对多关系。由于 Post 类含有外键 BlogId，因此使用 HasMany...WithOne 配置导航关系：

builder.HasMany<Post>().WithOne().HasForeignKey(x => x.BlogId).IsRequired();

• HasMany<Post>()：表示当前实体拥有多条 Post 记录。
• WithOne()：目标端无导航属性指向 Blog。
• IsRequired()：表示 BlogId 外键不可为空。

生成的迁移脚本分析

执行迁移后，EF Core 生成如下数据库结构：

• 创建表 T_Blogs，包含列：Id, Url, SoltCode。
• 创建表 Post，包含主键 Id 和外键 BlogId。
• 添加外键约束，关联 Post.BlogId 到 T_Blogs.Id，并启用级联删除。
• 为外键列建立索引以提升查询性能。

关键片段如下：

migrationBuilder.CreateTable(
    name: "T_Blogs",
    columns: table => new
    {
        Id = table.Column<int>(type: "int", nullable: false)
            .Annotation("MySql:ValueGenerationStrategy", MySqlValueGenerationStrategy.IdentityColumn),
        Url = table.Column<string>(type: "longtext", nullable: false)
            .Annotation("MySql:CharSet", "utf8mb4"),
        SoltCode = table.Column<string>(type: "longtext", nullable: false)
            .Annotation("MySql:CharSet", "utf8mb4")
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_T_Blogs", x => x.Id);
    });

总结

EF Core 提供了灵活的字段映射能力，支持：

• 将属性映射至私有字段；
• 控制属性/字段的访问优先级；
• 持久化没有公共属性的私有字段；
• 精确配置实体间的关系约束。

合理利用这些特性有助于实现更安全、更清晰的领域模型设计。