过滤类型(Filters Type) | 接口(Interface) | 默认实现(Default Implementation) | 描述(Description) |
Authorization | IAuthorizationFilter | AuthorizeAttribute | 首先运行,在其他过滤器的操作方法 |
Action | IActionFilter | ActionFilterAttribute | 运行之前和之后的动作方法 |
Result | IResultFilter | ActionFilterAttribute | 运行前后执行的操作结果 |
Exception | IExceptionFilter | HandleErrorAttribute | 如果只运行另一个过滤器,操作方法,或行动结果抛出一个异常 |
一、身份验证过滤器(Authorization):
1. 自定义类继承自相应的类或接口,重写方法,作为特性使用
eg.1 过滤器类型:Authorization(见上表)。自定义一个过滤器类(MyAuthorization : AuthorizeAttribute),重写方法:OnAuthorization();
public class MyAuthorization:AuthorizeAttribute
{
public override void OnAuthorization(AuthorizationContext filterContext)
{
//如果保留如下代码,则会运行.net framework定义好的身份验证,如果希望自定义身份验证,则删除如下代码
//base.OnAuthorization(filterContext);
//如果希望跳转到另外一个页面,需要使用Result,而不是使用Response.Redirect(),第二种方案不会让服务器端停止执行
//filterContext.Result=new RedirectResult(UrlHelper.GenerateUrl("","Login","UserInfo",""));
//获取路由数据:当前上下文匹配到路由规则后,得到的一个对象
//filterContext.RouteData
//获取上下文
filterContext.HttpContext.Response.Write("123");
}
}
2. 在控制器类中重写方法
eg.2 定义了一个MyBaseController 控制器,在该控制器中重写OnAuthorization方法。其他控制器 只要继承此控制器即可实现该过滤器。 ps:public class HomeController : MyBaseController
public class MyBaseController : Controller
{
//过滤器的第二种实现方式:重写控制器的方法,这样,会应用于所有的行为
protected override void OnAuthorization(AuthorizationContext filterContext)
{
filterContext.HttpContext.Response.Write("456");
}
}
3. 特性方法的使用
注意:如果继承自接口需要让类实现FilterAttribute, 才可以作为特性使用。
使用方式1: 作为Controller或Action的属性
eg.3: [MyAuthorization]
//[MyAuthorization]//当前控制器下的所有行为,都被应用了这个过滤器
public class HomeController : MyBaseController//Controller
{
//
// GET: /Home/
//[MyAuthorization]:当前行为在执行前,会执行身份验证过滤器
public ActionResult Index()
{
return View();
}
public ActionResult Show()
{
return View();
}
}
使用方式2:在Global中注册为全局过滤器,应用于所有的Controller 的 Action。
参数类均继承自ControllerContext,主要包含属性请求上下文,路由数据,结果
public class FilterConfig
{
public static void RegisterGlobalFilters(GlobalFilterCollection filters)
{
//在全局中注册过滤器,则所有控制器的所有行为,都会执行这个过滤器
filters.Add(new MyAuthorization());
}
}
二、异常处理过滤器(Exception)
l当发生异常时,用于进行自定义异步处理,如记录日志、跳转页面
l使用自定义异常处理,需要在web.config中为system.web添加<customErrorsmode="On" />节点
l重写OnException方法,不要禁用base.***
l如果想进行跳转,需要设置上下文对象的Result属性为new RedirectResult(stringurl);
三、行为过滤器(Action)
l在行为被执行前、后执行的过滤器
l重写方法OnActionExecuting(行为执行前)
l重写方法OnActionExecuted(行为执行后)
eg:
// 自定义过滤器类 MyAction.cs
public class MyAction:ActionFilterAttribute
{
//表示行为执行前,需要处理的代码
public override void OnActionExecuting(ActionExecutingContext filterContext)
{
filterContext.HttpContext.Response.Write("Action 执行前");
}
//表示行为执行后,需要处理的代码
public override void OnActionExecuted(ActionExecutedContext filterContext)
{
filterContext.HttpContext.Response.Write("Action 执行后");
}
}
// Home控制器下使用此过滤器
public class HelloController : Controller
{
[MyAction] //特性使用
public ActionResult Index()
{
Response.Write("行为执行中<br>");
return View();
}
}
四、结果过滤器(Result)
l在结果被执行前、后执行的过滤器
l重写方法OnResultExecuting(结果执行前)
l重写方法OnActionExecuted(结果执行后)
// 自定义类继承ActionFilterAttribute.
// MyResult.cs
public class MyResult:ActionFilterAttribute
{
//表示结果执行前,需要处理的代码
public override void OnResultExecuting(ResultExecutingContext filterContext)
{
filterContext.HttpContext.Response.Write("结果执行前<br>");
}
//表示结果执行地后,需要处理的代码
public override void OnResultExecuted(ResultExecutedContext filterContext)
{
filterContext.HttpContext.Response.Write("结果执行后<br>");
}
}
//HomeController 使用此过滤器
public class HelloController : Controller
{
[MyResult]
[MyAction]
public ActionResult Index()
{
Response.Write("行为执行中<br>");
return View();
}
}