ASP.NET Core中的资源筛选器是什么？如何创建？-C#.Net教程-PHP中文网

ASP.NET Core中的资源筛选器是什么？如何创建？

小老鼠

发布： 2025-09-04 08:49:01

原创

894人浏览过

资源筛选器是ASP.NET Core中最早执行的过滤器，作用于MVC请求管道，可用于缓存、授权、日志等全局任务，通过实现IResourceFilter接口或继承Attribute类创建，支持依赖注入，适用于需在控制器前后执行且与MVC上下文交互的场景。

asp.net core中的资源筛选器是什么？如何创建？

资源筛选器，简单来说，就是ASP.NET Core请求管道中的一道关卡，让你有机会在请求处理的早期介入，执行一些全局性的任务，比如缓存、授权，甚至可以短路请求直接返回响应。它比授权过滤器更早执行，比其他类型的过滤器作用域更广。

资源筛选器是ASP.NET Core中一种强大的请求处理管道组件，它允许你在请求到达控制器之前或之后执行代码。这使得资源筛选器非常适合处理横切关注点，例如缓存、授权和日志记录。

资源筛选器与其他过滤器的区别？

资源筛选器和其他过滤器（如授权过滤器、操作过滤器、异常过滤器和结果过滤器）的主要区别在于它们的执行顺序和作用域。

执行顺序： 资源筛选器是第一个执行的过滤器，在授权过滤器之前。这意味着资源筛选器可以影响授权过程，例如通过检查缓存并短路请求。
作用域： 资源筛选器的作用域比其他过滤器更广。它们可以影响整个请求处理管道，而不仅仅是特定的控制器或操作。

简单来说，你可以把资源过滤器看作是守门员，在请求进入“核心区域”之前，先进行一轮检查和处理。

如何创建自定义资源筛选器？

创建自定义资源筛选器，主要有两种方式：实现

IResourceFilter

登录后复制

接口或继承

Attribute

登录后复制

并实现

IResourceFilter

登录后复制

接口。推荐使用第二种方式，可以方便地通过特性标记来应用筛选器。

1. 实现

IResourceFilter

登录后复制

接口：

public class MyResourceFilter : IResourceFilter
{
    private readonly ILogger<MyResourceFilter> _logger;

    public MyResourceFilter(ILogger<MyResourceFilter> logger)
    {
        _logger = logger;
    }

    public void OnResourceExecuting(ResourceExecutingContext context)
    {
        _logger.LogInformation("MyResourceFilter - OnResourceExecuting");
        // 在这里执行请求处理前的逻辑
        // 例如：检查缓存，如果存在则短路请求
    }

    public void OnResourceExecuted(ResourceExecutedContext context)
    {
        _logger.LogInformation("MyResourceFilter - OnResourceExecuted");
        // 在这里执行请求处理后的逻辑
        // 例如：更新缓存
    }
}

登录后复制

2. 继承

Attribute

登录后复制

并实现
IResourceFilter
登录后复制
接口（推荐）：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
public class MyResourceFilterAttribute : Attribute, IResourceFilter
{
    private readonly ILogger<MyResourceFilterAttribute> _logger;

    public MyResourceFilterAttribute(ILogger<MyResourceFilterAttribute> logger)
    {
        _logger = logger;
    }

    public void OnResourceExecuting(ResourceExecutingContext context)
    {
        _logger.LogInformation("MyResourceFilterAttribute - OnResourceExecuting");
        // 在这里执行请求处理前的逻辑
        // 例如：检查缓存，如果存在则短路请求

        // 示例：短路请求
        // context.Result = new ContentResult { Content = "请求被资源筛选器短路！" };
    }

    public void OnResourceExecuted(ResourceExecutedContext context)
    {
        _logger.LogInformation("MyResourceFilterAttribute - OnResourceExecuted");
        // 在这里执行请求处理后的逻辑
        // 例如：更新缓存
    }
}

登录后复制

3. 注册筛选器：

在

Startup.cs

登录后复制

的

ConfigureServices

登录后复制

方法中注册筛选器：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers(options =>
    {
        // 全局注册
        // options.Filters.Add(new MyResourceFilter());
    });

    // 注册Logger
    services.AddLogging();

    // 注册筛选器依赖
    services.AddScoped<MyResourceFilter>();
    services.AddScoped<MyResourceFilterAttribute>();
}

登录后复制

4. 应用筛选器：

晓象AI资讯阅读神器

晓象-AI时代的资讯阅读神器

查看详情

全局应用： 在
```
ConfigureServices
```
登录后复制
中，通过
```
options.Filters.Add(new MyResourceFilter());
```
登录后复制
全局注册。
控制器或操作级别应用： 使用特性标记：
```
[MyResourceFilter]
```
登录后复制
或
```
[TypeFilter(typeof(MyResourceFilter))]
```
登录后复制

[ApiController]
[Route("[controller]")]
[MyResourceFilterAttribute] // 使用特性标记
public class WeatherForecastController : ControllerBase
{
    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet]
    //[TypeFilter(typeof(MyResourceFilter))] // 也可以这样使用
    public IEnumerable<WeatherForecast> Get()
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

登录后复制

注意，使用

TypeFilter

登录后复制

可以解决构造函数注入的问题，而直接使用特性标记则需要在

ConfigureServices

登录后复制

中注册依赖。

资源筛选器在实际项目中的应用场景有哪些？

资源筛选器的应用场景非常广泛，以下是一些常见的例子：

缓存： 在
```
OnResourceExecuting
```
登录后复制
中检查缓存，如果缓存命中，则短路请求，直接返回缓存数据。在
```
OnResourceExecuted
```
登录后复制
中更新缓存。
授权： 虽然有专门的授权过滤器，但资源筛选器可以在更早的阶段进行一些预授权检查，例如检查用户是否已登录。
日志记录： 记录请求的开始和结束时间，以及其他相关信息。
请求验证： 对请求数据进行全局验证，例如检查请求头是否包含必要的参数。
防止CSRF攻击： 在请求处理的早期阶段验证 Anti-Forgery Token。
全局异常处理： 虽然有异常过滤器，但资源筛选器可以在更早的阶段捕获一些异常，并进行处理。

如何在资源筛选器中访问和修改请求和响应？

在

ResourceExecutingContext

登录后复制

和

ResourceExecutedContext

登录后复制

中，你可以访问和修改请求和响应。

访问请求： 通过
```
context.HttpContext.Request
```
登录后复制
访问请求对象。你可以读取请求头、查询字符串、请求体等信息。
修改请求： 虽然不建议直接修改请求，但在某些情况下，你可能需要修改请求头或查询字符串。
访问响应： 通过
```
context.HttpContext.Response
```
登录后复制
访问响应对象。
修改响应： 你可以修改响应头、状态码、响应体等信息。
短路请求： 通过设置
```
context.Result
```
登录后复制
来短路请求，并返回自定义的响应。

例如，以下代码演示了如何在资源筛选器中读取请求头，并设置响应头：

public void OnResourceExecuting(ResourceExecutingContext context)
{
    string userAgent = context.HttpContext.Request.Headers["User-Agent"];
    _logger.LogInformation($"User-Agent: {userAgent}");

    context.HttpContext.Response.Headers.Add("X-Custom-Header", "Hello from Resource Filter");
}

登录后复制