ASP.NET Core 中的行动过滤器如何使用?

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

asp.net core 中的行动过滤器如何使用?

在 ASP.NET Core 中,行动过滤器(Action Filter)用于在控制器的某个动作方法执行前后插入自定义逻辑。它适用于日志记录、权限验证、参数校验、结果修改等场景。理解并正确使用行动过滤器可以提升代码的可维护性和复用性。

什么是行动过滤器?

行动过滤器是实现 IActionFilter 或继承 ActionFilterAttribute 的类,它允许你在动作方法执行前和执行后运行代码。ASP.NET Core 提供了多个过滤器接口,而行动过滤器主要关注的是 OnActionExecutingOnActionExecuted 两个方法:

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

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 17:12:35
下一篇 2025年12月17日 17:12:56

相关推荐

发表回复

登录后才能评论
关注微信