当前位置:

首页 > 编程开发 > C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

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

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

本文目录

    ASP.NET Core过滤器需关注执行顺序、作用域和DI生命周期;接口实现需手动注册,特性继承更常用但需满足构造函数要求;全局注册须注意scoped服务注入问题,Order值须显式设置以控制同类型过滤器执行顺序。

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

    ASP.NET Core的过滤器,很多人觉得它是个黑盒——写上去就能用,但实际远没那么简单。它的执行顺序、作用域,还有依赖注入的生命周期,这三个点但凡有一个没搞明白,过滤器就可能不触发、注入失败,或者行为完全不对。所以,想用好过滤器,先得把这几个关键点理清楚。

    过滤器接口选哪个:IActionFilter vs ActionFilterAttribute

    直接实现 IActionFilter 接口,灵活性是最高的,但得自己手动把它注册到DI容器里,比如 services.AddScoped()。这一步忘了,那 OnActionExecuting 方法压根不会被执行。相比之下,继承 ActionFilterAttribute 是更常见的做法——它自带属性语法,比如 [MyFilter] 就能直接用,而且在构造函数里注入依赖也是默认支持的。但要注意,这个类必须是 public 的,而且得有一个无参数构造函数,否则运行时就会报 InvalidOperationException: No constructor for type xxx 这样的错。

    • 如果想在多个 Action 上复用同一个过滤器,优先选 ActionFilterAttribute,再加上 [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)] 来控制它到底能用在方法上还是类上。
    • 要是想统一拦截所有请求,不想依赖属性标记,那就走全局注册的路子:options.Filters.Add()。但这时候必须得实现接口,而且得把服务注册好。
    • 在过滤器里要用 HttpContext 或 IConfiguration 吗?构造函数注入可以,但有个坑:全局注册的过滤器生命周期是 singleton,而 HttpContext 是 scoped 的,直接注入会报 Cannot resolve scoped service from root provider。正确做法是用 context.HttpContext.RequestServices.GetService() 按需解析。

    Order 值怎么设才真正控制执行顺序

    不少人以为 options.Filters.Add() 和 options.Filters.Add() 的调用顺序就是执行顺序,其实不是这么回事。默认情况下,通过 Add() 注册的过滤器,Order 值都是 0——是的,你没看错,全是 0。Order 相同时,后添加的反而先执行。所以,如果你想让日志过滤器在外层、认证在内层,就得显式指定 Order 值:

    options.Filters.Add(10); // 先执行
    options.Filters.Add(20); // 后执行

    需要特别注意的是,这个 Order 值只在同一类过滤器中生效。比如两个 IActionFilter 之间可以比较,但跨类型就不行——IAuthorizationFilter 永远比 IActionFilter 先执行,这是由框架设计决定的。

    • 控制器或 Action 上标注的属性过滤器,Order 默认是 -1,比全局注册的同类型过滤器优先级更高。
    • 如果混用了全局注册、特性标记、控制器级过滤器,建议全部显式设置 Order,避免靠“试出来”的顺序来维护。
    • Order = int.MinValue 和 int.MaxValue 可以作为安全边界,但别用 0 当“默认值”来凑数,那样容易乱。

    异常过滤器 IExceptionFilter 的常见失效场景

    IExceptionFilter 只捕获操作方法内部抛出的异常。模型绑定失败、中间件异常、授权失败(比如 UnauthorizedResult)这些情况,它都不会触发。典型的失效现象是:你加上了 [CustomExceptionFilter],但参数绑定出错时,比如字符串转 int 失败了,页面还是返回 400,而过滤器的 OnException 方法根本没进去。

    • 想统一处理模型绑定错误?得用 ModelStateInvalidFilter,它继承自 IActionFilter,在方法里检查 context.ModelState.IsValid 就行。
    • 想捕获授权失败?改用 IAuthorizationFilter,在 OnAuthorization 里判断 context.Result is UnauthorizedResult。
    • 想记录所有未处理异常,包括中间件抛出的?应该用 UseExceptionHandler 中间件,而不是过滤器。
    • 还有一点,context.ExceptionHandled = true 必须显式设置,否则异常会继续向上冒泡,可能被外层中间件再次处理,导致行为异常。

    DI 注入时 Scoped 服务拿不到的典型错误

    全局注册的过滤器默认是 singleton 生命周期,但很多业务服务,比如 IDbContextFactory、ILogger,都是 scoped 的。直接通过构造函数注入,启动时就会报错:Cannot consume scoped service 'xxx' from singleton 'yyy'。

    • 解决方案一:把过滤器本身也注册为 Scoped。但要注意,全局过滤器设为 scoped 后,每次请求都会新建实例,性能开销会稍微增加。
    • 解决方案二:在方法体内用 context.HttpContext.RequestServices.GetService() 来获取服务。这是最稳妥的做法,特别适合日志、配置、缓存这类轻量级依赖。
    • 千万别在 OnActionExecuting 里 new 一个 DbContext,它不会自动加入当前请求的变更跟踪,Sa veChanges 可能会静默失败,查都查不到。

    最容易被忽略的一点是:过滤器的执行时机与 MVC 管道阶段是强绑定的,并不是“代码写了就运行”。比如资源过滤器的 OnResourceExecuting 在模型绑定之前执行,这时候 context.ActionArguments 还是空的;而动作过滤器的 OnActionExecuting 执行时,才能看到绑定后的参数。如果看错了阶段,就很容易对着空值做逻辑判断,结果自然不对。

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

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

    圆通速递查单号官网
    圆通速递查单号官网

    圆通速递查单号官网在哪里? 不少朋友都在寻找圆通快递的官方物流查询入口。别急,这就为你揭晓答案,并带你详细了解它的核心功能与服务。 圆通速递的官方网站地址是:https://www.yto.net.cn/。记住这个地址,所有官方服务都从这里开始。 官网核心功能 来到官网,你会发现它的运单查询服务是全

    在小说搜搜找不到想看的小说怎么办?小说搜搜换源功能使用详解【必学】
    在小说搜搜找不到想看的小说怎么办?小说搜搜换源功能使用详解【必学】

    小说搜搜搜索不到结果?五种实用解决方法帮你搞定 在小说搜搜里搜不到想看的书?这事儿其实挺常见。问题多半出在书源上——要么是默认的书源还没来得及收录,要么是原先的源数据失效了,更新没跟上。别急,下面这五条解决路径,基本能覆盖绝大多数情况,操作起来也不复杂。 一、通过阅读页调出换源入口手动切换 这个方法

    来看小说网最新章节免费阅读网
    来看小说网最新章节免费阅读网

    来看小说网最新章节免费阅读网-来看小说网全网小说同步更新入口 不少资深书友都在问,来看小说网的全网小说同步更新入口究竟在哪?别急,答案就在这里。接下来,就为大家详细揭开这个平台的神秘面纱,看看它究竟提供了怎样的阅读体验。 来看小说网的官方入口是:https://www.kanxiaoshuo.net

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

    编程的本质是创造性的严谨翻译,通过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库在输出目录中。

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

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

    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 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。