C#怎么实现EFCore的软删除_C#如何配置全局查询筛选器【案例】

梦宇酱_2617

梦宇酱_2617

2026-03-23

498人浏览

原创

EF Core软删除必须用HasQueryFilter实现全局查询拦截,仅加IsDeleted字段无效;需在OnModelCreating中为实体配置,且仅影响查询操作,SaveChanges不受影响。

c#怎么实现efcore的软删除_c#如何配置全局查询筛选器【案例】

EFCore 软删除必须用 HasQueryFilter,不是加个字段就完事

软删除不是靠业务层手动写 WHERE IsDeleted = false,EF Core 里它本质是「全局查询拦截」。不配置 HasQueryFilter,哪怕模型里有 IsDeleted 字段,查询照样返回已“删”数据——这是最常踩的坑。

配置位置在 OnModelCreating 里,且只对继承自 DbContext 的实体生效:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<order>()
        .HasQueryFilter(x => !x.IsDeleted);
}</order>
  • HasQueryFilter 只影响查询(Find、ToList、First 等),不影响 SaveChanges
  • 若实体有多个软删除字段(如 IsDeleted + DeletedBy),过滤器里得全写上,否则可能漏筛
  • 导航属性加载(Include)也会被过滤,但注意:如果主表没被过滤(比如你临时禁用了),关联表仍按自己的过滤器走

全局筛选器要支持“查已删数据”,得用 IgnoreQueryFilters

管理后台常要查“已删除订单”,这时不能删掉过滤器重配,而是运行时绕过。EF Core 提供 IgnoreQueryFilters 方法,但它只作用于当前查询链:

var deletedOrders = context.Orders
    .IgnoreQueryFilters()
    .Where(x => x.IsDeleted)
    .ToList();
  • IgnoreQueryFilters() 必须放在 Where 前,放后面无效
  • 它不解除嵌套查询的过滤(比如 Include(x => x.Items) 中的 Items 仍受自己过滤器约束)
  • 别在仓储基类里默认调用它——会破坏软删除语义,除非你明确分“前台/后台”上下文

IsDeleted 字段类型和默认值直接影响迁移和性能

用 bool 最稳妥,但有人图省事用 int 或 string 存状态(如 0/1/"Y"/"N"),这会导致两个问题:迁移失败 + 查询无法内联。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • EF Core 6+ 对 HasQueryFilter 中的表达式有编译限制,x.Status == 1 可能报 InvalidOperationException: The LINQ expression could not be translated
  • 数据库索引失效:如果字段是 int,即使加了 WHERE Status = 0,优化器也可能不走索引(尤其 SQL Server)
  • 迁移脚本里 IsDeleted 默认值必须设为 false,否则老数据全被“过滤掉”,上线就丢数据

软删除 + 级联删除混用时,HasForeignKey 配置必须显式声明

比如 Order 和 OrderItem,你希望删 Order 时只软删,但 OrderItem 也得跟着软删。这时候不能依赖 EF 默认级联,必须手动配:

modelBuilder.Entity<orderitem>()
    .HasOne(x => x.Order)
    .WithMany(x => x.Items)
    .HasForeignKey(x => x.OrderId)
    .OnDelete(DeleteBehavior.ClientSetNull); // 关键:不能用 Cascade</orderitem>
  • DeleteBehavior.Cascade 会触发物理删除,直接绕过软删逻辑
  • ClientSetNull 或 NoAction 更安全,软删动作由业务代码或触发器控制
  • 如果用 ChangeTracker 手动标记子项为 Modified 并改 IsDeleted,记得关掉自动检测变更(context.ChangeTracker.AutoDetectChangesEnabled = false),否则性能跳变

软删除真正难的不是加一行 HasQueryFilter,而是所有关联操作都得重新对齐语义——查、删、连查、导出、甚至备份还原,都得心里有数哪一层在过滤、哪一层被绕过了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2883

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6283

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7190

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7018

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1003

5

c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

1132

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

3351

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

945

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

2655

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习