EF Core NotMapped注解怎么用 EF Core忽略属性映射教程

来源:这里教程网 时间:2026-02-21 17:33:34 作者:

EF Core 的 [NotMapped] 注解用来告诉框架:这个属性不参与数据库映射,不会生成对应列,也不会在查询或保存时读写数据库。它最常用于计算属性、临时字段、前端展示用的组合值,或者纯内存中使用的辅助数据。

什么时候必须加 [NotMapped]?

只要属性不对应数据库中的任何一列,又确实定义在实体类里(比如为了方便前端展示或业务逻辑),就必须标记

[NotMapped]
,否则 EF Core 会尝试为它建列,导致迁移失败或运行时报错。

只读计算属性(如
public string FullName => FirstName + " " + LastName;
临时状态字段(如
public bool IsSelected { get; set; }
,仅用于页面勾选)
敏感但不落库的数据(如
public string TempToken { get; set; }
与外键同名但非导航用途的普通字段(避免被误判为关联)

怎么写?基础用法很简单

确保引入命名空间:

using System.ComponentModel.DataAnnotations.Schema;

然后直接加在属性上:

[NotMapped]
public string DisplayCode => $"{GoodsName.Substring(0, 1)}:{Location}";

注意:该属性可以是自动属性、只读属性(只有

get
)、或完整属性(
get
+
set
),EF Core 都会跳过——前提是加了
[NotMapped]

不加的话,哪怕只有

get
,EF Core 也可能因其他配置(如 Fluent API 中未忽略)而报错;加了就明确、安全、无歧义。

类级别也能用 [NotMapped]

如果整个类只是做中间计算或 DTO 用途,不希望它在数据库里有任何表,可以直接标在类上:

[NotMapped]
public class CalculationResult
{
    public string Description { get; set; }
    public decimal Value { get; set; }
}

这样 EF Core 在构建模型时会完全跳过这个类型,不会为它生成迁移,也不会出现在

DbContext
DbSet
中。

替代方案:Fluent API 忽略属性

如果你倾向把映射逻辑集中到

OnModelCreating
里,也可以不用注解:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Goods>()
        .Ignore(g => g.GoodsCode);
}

这种方式适合团队规范要求“注解只管校验,映射全走 Fluent”,也方便统一管理忽略项。但日常开发中,

[NotMapped]
更直观、更易维护。

基本上就这些。用对地方,不漏加,不乱加——EF Core 就不会为你的“假字段”建真列。

相关推荐