行动过滤器是实现IActionFilter或继承ActionFilterAttribute的类,用于在动作方法执行前后插入逻辑。通过OnActionExecuting和OnActionExecuted方法,可实现日志记录、权限验证、参数校验和结果修改。例如,LogActionFilter使用Stopwatch记录执行时间。过滤器可应用于单个控制器或方法,也可在Program.cs中全局注册。典型应用场景包括权限检查、模型验证、性能监控和统一响应包装。合理使用可提升代码复用性和可维护性,但应避免在过滤器中执行耗时操作以免影响性能。

在 ASP.NET Core 中,行动过滤器(Action Filter)用于在控制器的某个动作方法执行前后插入自定义逻辑。它适用于日志记录、权限验证、参数校验、结果修改等场景。理解并正确使用行动过滤器可以提升代码的可维护性和复用性。
什么是行动过滤器?
行动过滤器是实现 IActionFilter 或继承 ActionFilterAttribute 的类,它允许你在动作方法执行前和执行后运行代码。ASP.NET Core 提供了多个过滤器接口,而行动过滤器主要关注的是 OnActionExecuting 和 OnActionExecuted 两个方法:
OnActionExecuting:在动作方法执行前调用,可用于拦截请求(如验证失败时返回错误)。 OnActionExecuted:在动作方法执行后调用,可用于修改结果或记录执行信息。
创建自定义行动过滤器
下面是一个简单的示例,展示如何创建一个记录请求时间的行动过滤器:
using Microsoft.AspNetCore.Mvc.Filters;using System.Diagnostics;public class LogActionFilter : ActionFilterAttribute{ private Stopwatch _stopwatch; public override void OnActionExecuting(ActionExecutingContext context) { _stopwatch = Stopwatch.StartNew(); Console.WriteLine($"开始执行动作: {context.ActionDescriptor.DisplayName}"); } public override void OnActionExecuted(ActionExecutedContext context) { _stopwatch?.Stop(); Console.WriteLine($"动作执行完成,耗时: {_stopwatch.ElapsedMilliseconds}ms"); }}
注册和使用过滤器
行动过滤器可以在多个级别注册,控制其作用范围:
应用到单个控制器或动作:直接在控制器或方法上添加特性。
[LogActionFilter]public class HomeController : Controller{ [HttpGet] public IActionResult Index() { return View(); }}
全局注册:在 Program.cs 中将过滤器添加到 MVC 配置中,使其对所有动作生效。
var builder = WebApplication.CreateBuilder(args);builder.Services.AddControllersWithViews(options =>{ options.Filters.Add();});
常见应用场景
行动过滤器适合处理横切关注点。几个典型用途包括:
权限检查:在 OnActionExecuting 中判断用户是否有权访问当前操作,若无则设置 context.Result 返回 403。 模型验证增强:如果模型状态无效,可提前终止执行并返回错误响应。 性能监控:像上面的例子一样,测量每个动作的执行时间。 修改输出结果:在 OnActionExecuted 中更改 context.Result,例如统一包装 API 响应格式。
基本上就这些。掌握行动过滤器的使用,能让控制器更干净,通用逻辑更容易集中管理。注意不要在过滤器中做太重的操作,避免影响整体性能。
以上就是ASP.NET Core 中的行动过滤器如何使用?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1440574.html
微信扫一扫
支付宝扫一扫