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

[NotMapped]用于标记不参与数据库映射的属性或类，避免EF Core为其生成列或表；适用于计算属性、临时字段、敏感数据等，既可标注在属性上也可标注在类上，Fluent API中亦可用Ignore替代。

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 中未忽略）而报错；加了就明确、安全、无歧义。

标签： 前端 go app 敏感数据