ASP 中有哪些常用的过滤函数，它们各自有什么作用？

ASP.NET中的过滤函数

在ASP.NET Core中，过滤器（Filters）是一种强大的工具，用于拦截和修改请求与响应的处理过程，它们可以在控制器或操作方法执行前后运行，实现诸如认证、日志记录、异常处理等功能，本文将详细介绍ASP.NET Core中的几种主要过滤器及其使用方法。

一、过滤器类型

1、授权过滤器（Authorization filters）：这些过滤器用于处理授权逻辑，确定当前用户是否有权限访问特定的控制器或操作方法。

2、资源过滤器（Resource filters）：在模型绑定之前和之后运行，通常用于缓存或其他资源相关的操作。

3、操作过滤器（Action filters）：在操作方法执行之前和之后运行，可以对传递给操作的参数和返回的结果进行修改。

4、异常过滤器（Exception filters）：用于处理控制器或操作方法中引发的异常，提供全局的异常处理策略。

5、结果过滤器（Result filters）：在操作结果执行之前和之后运行，包装单个操作结果的执行，例如视图渲染。

二、创建和使用自定义过滤器

1. 创建自定义过滤器

自定义过滤器通常通过实现特定的接口来创建，例如IAuthorizationFilter,IResourceFilter,IActionFilter,IExceptionFilter,IResultFilter，以下是一个实现IActionFilter接口的示例：

public class CustomActionFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        // 在操作执行前执行的逻辑
    }
    public void OnActionExecuted(ActionExecutedContext context)
    {
        // 在操作执行后执行的逻辑
    }
}

2. 注册过滤器

自定义过滤器需要在应用程序的服务集合中注册，以便ASP.NET Core能够解析它们，以下是使用构造函数注入的方式注册过滤器：

services.AddScoped<MyCustomFilter>();
services.AddControllers(options =>
{
    options.Filters.Add<MyCustomFilter>(); // 添加自定义全局过滤器
});

3. 应用过滤器

可以通过特性（Attribute）的方式将过滤器应用于控制器或操作方法：

[TypeFilter(typeof(MyCustomFilter))]
public class MyController : ControllerBase
{
    // 控制器动作
}

或者在操作方法上应用过滤器：

[TypeFilter(typeof(MyCustomFilter))]
public IActionResult MyAction()
{
    // 动作逻辑
}

三、跳过过滤器

有时可能需要在某些特定操作上跳过已应用的过滤器，可以通过创建一个自定义特性并检查该特性来实现：

[AttributeUsage(AttributeTargets.Method, Inherited = false, AllowMultiple = false)]
public class SkipFilterAttribute : Attribute
{
}

然后在主过滤器中进行检查：

public class MyCustomFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        if (context.ActionDescriptor.EndpointMetadata.OfType<SkipFilterAttribute>().Any())
        {
            return; // 如果存在SkipFilterAttribute，则跳过过滤逻辑
        }
        // 过滤逻辑
    }
    public void OnActionExecuted(ActionExecutedContext context)
    {
    }
}

四、相关问答FAQs

Q1: 如何在ASP.NET Core中使用授权过滤器进行身份验证？

A1: 授权过滤器主要用于处理用户的身份验证和授权，可以通过实现IAuthorizationFilter接口来创建自定义授权过滤器，并在服务集合中注册它，然后通过特性将其应用于控制器或操作方法。

public class CustomAuthFilter : IAuthorizationFilter
{
    public void OnAuthorization(AuthorizationFilterContext context)
    {
        // 身份验证逻辑
        if (!context.HttpContext.User.Identity.IsAuthenticated)
        {
            context.Result = new JsonResult({ message = "未授权" }) { StatusCode = StatusCodes.Status401Unauthorized };
        }
    }
}

注册并应用过滤器：

services.AddScoped<CustomAuthFilter>();
services.AddControllers(options =>
{
    options.Filters.Add<CustomAuthFilter>(); // 添加全局授权过滤器
});

Q2: 如何创建和使用异常过滤器来处理控制器中的异常？

A2: 异常过滤器用于捕获和处理控制器或操作方法中抛出的异常，可以通过实现IExceptionFilter接口来创建自定义异常过滤器，并在服务集合中注册它，然后通过特性将其应用于控制器或操作方法。

public class CustomExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        // 异常处理逻辑
        context.Result = new JsonResult({ message = "发生错误" }) { StatusCode = StatusCodes.Status500InternalServerError };
        context.ExceptionHandled = true; // 标记为已处理
    }
}

注册并应用过滤器：

services.AddScoped<CustomExceptionFilter>();
services.AddControllers(options =>
{
    options.Filters.Add<CustomExceptionFilter>(); // 添加全局异常过滤器
});

以上就是关于“asp 过滤函数”的问题，朋友们可以点击主页了解更多内容，希望可以够帮助大家!