ASP.NET Core 中的行动过滤器如何使用？-C#.Net教程-PHP中文网

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

煙雲

发布： 2025-10-12 11:14:01

原创

653人浏览过

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

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

在 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");
    }
}

登录后复制

注册和使用过滤器

行动过滤器可以在多个级别注册，控制其作用范围：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

应用到单个控制器或动作：直接在控制器或方法上添加特性。

[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<LogActionFilter>();
});

登录后复制

常见应用场景

行动过滤器适合处理横切关注点。几个典型用途包括：

权限检查：在 OnActionExecuting 中判断用户是否有权访问当前操作，若无则设置 context.Result 返回 403。
模型验证增强：如果模型状态无效，可提前终止执行并返回错误响应。
性能监控：像上面的例子一样，测量每个动作的执行时间。
修改输出结果：在 OnActionExecuted 中更改 context.Result，例如统一包装 API 响应格式。