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

畫卷琴夢
发布: 2025-12-15 17:18:08
原创
544人浏览过
[NotMapped]用于标记不参与数据库映射的属性或类,避免EF Core为其生成列或表;适用于计算属性、临时字段、敏感数据等,既可标注在属性上也可标注在类上,Fluent API中亦可用Ignore替代。

ef core notmapped注解怎么用 ef core忽略属性映射教程

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

Visla
Visla

AI视频生成器,快速轻松地将您的想法转化为视觉上令人惊叹的视频。

Visla 100
查看详情 Visla

类级别也能用 [NotMapped]

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

[NotMapped]
public class CalculationResult
{
    public string Description { get; set; }
    public decimal Value { get; set; }
}
登录后复制

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

替代方案:Fluent API 忽略属性

如果你倾向把映射逻辑集中到 OnModelCreating 里,也可以不用注解:

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

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

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

以上就是EF Core NotMapped注解怎么用 EF Core忽略属性映射教程的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号