讲师中心 微信公众号
AI工具推荐 视频效率加速

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

梦宇酱_2617

梦宇酱_2617

发布时间:2026-03-23 10:24:37

|

498人浏览过

|

来源于php中文网

原创

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

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

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

C#
C#

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

下载
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"),这会导致两个问题:迁移失败 + 查询无法内联。

  • 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
  • DeleteBehavior.Cascade 会触发物理删除,直接绕过软删逻辑
  • ClientSetNull 或 NoAction 更安全,软删动作由业务代码或触发器控制
  • 如果用 ChangeTracker 手动标记子项为 Modified 并改 IsDeleted,记得关掉自动检测变更(context.ChangeTracker.AutoDetectChangesEnabled = false),否则性能跳变

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

热门AI工具

更多
Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

2883

2023.08.11

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

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

6283

2023.10.09

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

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

7190

2024.03.19

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

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

7018

2024.03.22

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

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

1003

2024.05.22

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

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

1132

2023.08.08

什么是c#
什么是c#

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

3351

2023.08.31

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

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

945

2024.03.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

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

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn