当前位置:

首页 > 编程开发 > C#怎么使用EF Core拦截器_C#数据库操作拦截器教程【进阶】

C#怎么使用EF Core拦截器_C#数据库操作拦截器教程【进阶】

EFCore拦截器需在实例创建前注册,推荐依赖注入时配置。DbCommandInterceptor重写CommandExecuting可为SELECT加NOLOCK,但需判断数据库类型且避免破坏SQL结构。SaveChangesInterceptor中可获取变更实体,填充审计字段需避免递归调用。HasQueryFilter与拦截器共存时Include结果为空

本文目录

    关于EF Core拦截器,有不少朋友在实际项目中踩过坑。这篇文章把几个核心要点直接梳理清楚,省去反复调试的时间。

    C#怎么使用EF Core拦截器_C#数据库操作拦截器教程【进阶

    DbCommandInterceptor 怎么注册才生效

    拦截器必须在 DbContextOptionsBuilder 配置阶段注册,并且一定要赶在 DbContext 实例创建之前。一个常见的陷阱是:拦截器加在了 OnConfiguring 方法里,结果后面又用 AddDbContext 把配置覆盖了,拦截器自然就丢了。

    推荐的做法,是在依赖注入容器注册时统一传入:

    services.AddDbContext(options =>{    options.UseSqlServer(connectionString);    options.AddInterceptors(new NoLockCommandInterceptor()); // ✅ 正确:AddInterceptors 在 UseSqlServer 之后});

    这里有几个需要注意的点:

    • 拦截器类必须继承 DbCommandInterceptor,不能只实现一下接口就完事。
    • 如果同时注册了多个拦截器,执行顺序按注册先后排列。不过要注意,EF Core不保证线程安全,所以不要在拦截器里修改共享状态。
    • 使用单例实例(比如 static readonly)比每次 new 一个要高效得多,EF Core 是允许复用拦截器实例的。

    怎么给 SELECT 自动加 NOLOCK(SQL Server 场景)

    这大概是 DbCommandInterceptor 最典型的一个应用场景。不过需要先泼盆冷水:NOLOCK 只对 SQL Server 有效,而且有读脏数据的风险。更重要的是,不能不加区分地乱加,得判断一下命令类型,确认是查询语句才行。

    关键操作在于重写 CommandExecuting 方法,然后检查 command.CommandText.StartsWith("SELECT", StringComparison.OrdinalIgnoreCase):

    public override InterceptionResult CommandExecuting(    DbCommand command,    CommandEventData eventData,    InterceptionResult result){    if (command.CommandType == CommandType.Text &&        command.CommandText.TrimStart().StartsWith("SELECT", StringComparison.OrdinalIgnoreCase))    {        command.CommandText = "SELECT * FROM (" + command.CommandText + ") AS t WITH (NOLOCK)";    }    return base.CommandExecuting(command, eventData, result);}

    这里有个容易犯的错误:不要直接在原始 SQL 后面拼接 "SELECT ... WITH (NOLOCK)"。因为原始 SQL 里可能含有子查询、CTE 或者注释,简单的字符串替换会直接破坏语法结构。更稳妥的做法是解析一下 SQL,或者只对已知的简单查询生效。

    另外,如果项目同时支持 PostgreSQL 或 MySQL,这些数据库是不认 WITH (NOLOCK) 的。所以拦截器里还需要根据 eventData.Connection?.DatabaseProvider 做一下分支处理。

    Sa veChangesInterceptor 修改实体前/后怎么取到变更数据

    Sa veChangesInterceptor 的 Sa vingChanges 方法可以拿到即将提交的 DbContext 实例。这个时候变更跟踪器(ChangeTracker)已经处于“准备提交”的状态,遍历所有 EntityEntry 是安全的。

    典型的审计场景,比如自动填充 CreatedTime 和 ModifiedTime:

    public override void Sa vingChanges(DbContextEventData eventData, CancellationToken cancellationToken){    var context = eventData.Context;    if (context == null) return;
    
    var entries = context.ChangeTracker.Entries()
        .Where(e => e.Entity is IAuditable &&
                      (e.State == EntityState.Added || e.State == EntityState.Modified));
    
    foreach (var entry in entries)
    {
        var entity = (IAuditable)entry.Entity;
        if (entry.State == EntityState.Added)
            entity.CreatedTime = DateTime.UtcNow;
        entity.ModifiedTime = DateTime.UtcNow;
    }
    
    base.Sa vingChanges(eventData, cancellationToken);
    }

    这里有几个需要注意的地方:

    • 千万不要在 Sa vingChanges 里调用 entry.Reload() 或触发新的查询,否则会引起递归或者死锁。
    • IAuditable 接口需要自己定义,字段名要和数据库列保持一致,不然 EF 会映射失败。
    • 如果实体有导航属性也需要一起审计(比如关联的 User),需要手动遍历 entry.Na vigations,默认情况下是不会递归处理的。

    HasQueryFilter 和拦截器共存时为什么 Include 关联数据为空

    这个问题其实不是拦截器造成的,而是 HasQueryFilter 的默认行为。EF Core 会对主实体以及它所有 Include 的导航集合都应用同一个过滤器。举个例子,如果 User 设置了软删除过滤,那么 Include(u => u.Orders) 也会被加上 !o.IsDeleted 条件。如果订单表根本没有这个字段,生成的 SQL 要么报错,要么返回空数据。

    解决方式不是靠拦截器去改 SQL,而是调整模型配置:

    • 对导航目标实体(比如 Order)单独配置 HasQueryFilter,并且条件只作用于该实体自身的字段。
    • 用 AsNoTrackingWithIdentityResolution() 绕过跟踪器的过滤逻辑(这只适合只读场景)。
    • 改用显式加载:context.Entry(user).Collection(u => u.Orders).Load(),这种方式不走全局过滤器。
    • 最干净的方式是移除导航上的级联过滤,改用投影(Select)或原生 SQL 来显式控制关联查询条件。

    在这个问题上,拦截器确实帮不上忙——它看到的是最终生成的 SQL,而问题出在 EF Core 查询表达式树的构建阶段,那个时候 SQL 还没生成呢。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 C#
    相关文章 更多
    winforms教程自学入门与基础开发步骤详解
    winforms教程自学入门与基础开发步骤详解

    本教程详细讲解如何使用Visual Studio创建WinForms项目,通过添加按钮和标签控件并编写点击事件代码,实现一个基础的计数器功能,适合C#初学者快速上手Windows窗体应用开发。

    谈编程与编程语言
    谈编程与编程语言

    编程的本质是创造性的严谨翻译,通过for、if和函数调用实现重复计算任务。语言发展让集成度提高,门槛降低但竞争加剧。程序员需培养整体架构能力,抓住思想精髓而非追逐新技术,方能长远发展。

    什么是面向接口编程、面向过程编程、面向对象编程?
    什么是面向接口编程、面向过程编程、面向对象编程?

    面向接口编程通过接口解耦,降低耦合度并提升可扩展性和维护性,是面向对象思想的精髓。面向过程编程将问题拆解为步骤,用函数依次执行。面向对象编程将事物抽象为对象,封装属性和方法,通过对象协作解决问题。

    我对编程的一些感悟
    我对编程的一些感悟

    编程这件事,说到底是门手艺活,但又不全是手艺。把代码写出来容易,把代码写好、写出境界,那就得看功夫了。今天聊几个核心判断,算是多年敲键盘的一点沉淀。 一、语言是功夫,思路是内功 编程语言五花八门,就像武林高手会的功夫一样,但想成为顶尖高手,内功必须深厚。内功到了,学新功夫就是分分钟的事。看过《倚天屠

    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程
    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程

    abstract类不能被直接实例化,子类必须用override实现其所有抽象方法。抽象类可实现接口,并以抽象方法转发接口成员。抽象类不能与sealed共用,其抽象方法默认隐式virtual且无方法体。可包含字段、属性等非抽象成员。

    c#如何删除文件_c#删除文件的正确用法与注意事项
    c#如何删除文件_c#删除文件的正确用法与注意事项

    C#删除文件前应先判断存在性以防异常,注意权限不足和文件被占用。File.Delete与FileInfo.Delete功能相同,后者适合多次操作。无异步删除方法,推荐后台执行或限流以避免阻塞。

    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点
    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点

    在EmguCV中,进行Bitmap转Image时,需先转为24位无Alpha格式,以避免颜色错乱问题;Image转Bitmap时,建议使用Mat或ImageBox控件,以有效减少内存拷贝;跨线程处理时,应使用Mat.Clone()进行深拷贝,以确保数据安全;DLL加载失败时,需设置x64平台目标,并确保native库在输出目录中。

    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】
    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】

    C#图表生成中,LiveCharts需用ChartValues数据集合,并在更新后触发重绘;OxyPlot饼图需启用交互与标签;包引用务必注意版本适配;导出图片需在布局完成后操作,并校正DPI缩放以确保清晰度。

    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】
    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

    ASP.NETCore过滤器需关注执行顺序、作用域与DI生命周期。接口实现需手动注册,特性继承更常用但需满足构造函数要求。全局注册时注意scoped服务注入问题,Order值须显式设置以控制同类型过滤器执行顺序。异常过滤器仅捕获操作方法内异常,模型绑定与授权失败须分别处理。

    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例
    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例

    实现全局鼠标钩子需使用SetWindowsHookEx配合WH_MOUSE_LL,窗体级事件仅捕获本进程消息。回调函数必须为静态且标记特定签名,禁止阻塞操作。通过Marshal.PtrToStructure解析lParam获取坐标与按键状态。钩子生命周期绑定线程,需注意注册线程持续运行并双重卸载,避免句柄泄漏。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。