×

iFour Logo

What is Exception Filter and explain custom Exception Filter in ASP.NET MVC?

Kapil Panchal - July 15, 2021

Listening is fun too.

Straighten your back and cherish with coffee - PLAY !

  • play
  • pause
  • pause
What is Exception Filter and explain custom Exception Filter in ASP.NET MVC?

What is an Exception Filter?


Exception Filter provides an ability to handle the exception for all the method, controller classes in one place. Exception filters execute when some of the exceptions are thrown from an action. The exception can be anything. This is by creating a class that inherits from IExceptionFilter and FileAttribute interface.

Custom Exception Filter


Exception Filter provides a built-in HandleError attribute to handle exception filter with the built-in attribute we can’t do the following things.

  1. Cannot log the Exception using the HandleError attribute
  2. It is not possible to handle exception occurs outside the controllers.
  3. Exception handling is not possible, depending on the scenario. For Example, one error page when the request comes through AJAX and a different one is a normal request.

Let's look at how to work around these problems by creating a custom exception filter.

Creating Custom Exception Filter


Here I am creating an Employee class for the model inside the model folder.


Employee. class
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace LIBData
{
   public class Employee  
    {  
        public int Id { 
get; 
set;
 }  
   
        [Required(ErrorMessage = "Name Required")]  
        public string Name { 
get; 
set;
 }  
        [Required(ErrorMessage = " Designation Required ")]  
        public string Designation{ 
get; 
set;
 }  
        [Required(ErrorMessage = "Salary Required ")]  
        public int Salary { 
get; 
set;
 }  
    }  
}
				

Now we need to add controller class inside the controller folder add.


EmployeeController
using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Web;  
using System.Web.Mvc;  
using LIBUser.CustomFilter;  
using LIBUser.Models;  
   
namespace LIBUser.Controllers
{
    public class EmployeeController: Controller
    {
        public EmployeeContext  db =  new EmployeeContext();
        public ActionResult Index()
        {
            var employee = db .Employees.ToList();
            return View(employee);
        }
        public ActionResult Details(int? id)
        {
            if (id == null)
            {
                return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
            }
            Employee employee = db.Employees.Find(id);
            if (employee == null)
            {
                return HttpNotFound();
            }
            return View(employee);
        }
        public ActionResult Create()
        {
            return View();
        }
        [HttpPost]
        [CustomExceptionHandlerFilter]
        public ActionResult Create(Employee employee)
        {
            if (ModelState.IsValid)
            {
                if (employee.Designation== "JuniorForntEndDeveloper" && (employee.Salary < 1000 || employee.Salary > 4000))
                {
                    throw new Exception("Salary is not matching with JuniorForntEndDeveloper.");
                }
                else if (employee.Designation== "WebDeveloper" && (employee.Salary < 30000 || employee.Salary > 40000))
                {
                    throw new Exception("Salary is not matching with WebDeveloper.");
                }
                else if (employee.Designation== "Marketing Manager")
                {
                    throw new Exception("Salary is not matching with Marketing Manager");
                }
                else
                {
                    db .Employees.Add(employee);
                    db .SaveChanges();
                }
            }
            return RedirectToAction("Index");
        }
    }
}
				

Add the following line of code inside the Employee controller.

In this example, I will just demonstrate how to use a Custom Exception filter you can change your controller as per the requirements.

Now, we need to add the view for Create action method and Index action method. Right-click on create method and add view.


Create View

@model LIBData.Employee
@{
    ViewBag.Title = "Create";
    Layout = "~/Views/Shared/LibStudent.cshtml";
}
Add Employee Details
@using (Html.BeginForm()) { @Html.AntiForgeryToken()

Employee


@Html.ValidationSummary(true, "", new { @class = "text-danger" })
@Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" }) @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" })
@Html.LabelFor(model => model.Designation, htmlAttributes: new { @class = "control-label col-md-2" }) @Html.EditorFor(model => model.Designation, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Designation, "", new { @class = "text-danger" })
@Html.LabelFor(model => model.Salary, htmlAttributes: new { @class = "control-label col-md-2" }) @Html.EditorFor(model => model.Salary, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Salary, "", new { @class = "text-danger" })
}
@Html.ActionLink("Back to List", "Index")

Add the CustomExceptionHandlerFilter class for creating a custom exception handler.

Implements FilterAttribute and IExceptionFilter and overrides the OnException method.

 
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
namespace LIBUser.Controllers
{
    public class CustomExceptionHandlerFilter: FilterAttribute, IExceptionFilter
    {
        public void OnException(ExceptionContext filterContext)
        {
            ExceptionLogger logger = new ExceptionLogger()
            {
                ExceptionMessage = filterContext.Exception.Message,
                ExceptionStackTrack = filterContext.Exception.StackTrace,
                ControllerName = filterContext.RouteData.Values["controller"].ToString(),
                ActionName = filterContext.RouteData.Values["action"].ToString(),
                ExceptionLogTime = DateTime.Now
            };
            EmployeeContext dbContext = new EmployeeContext();
            dbContext.ExceptionLoggers.Add(logger);
            dbContext.SaveChanges();
            filterContext.ExceptionHandled = true;
            filterContext.Result = new ViewResult()
            {
                ViewName = "Error"
            };
        }
    }
}
				

Open App_Start folder inside the App_start folder contains FilterConfig class. Inside this class, we add our new CustomExceptionHandlerFilter in the following way.

 
using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Web;  
using System.Web.Mvc;  
using Microsoft.ApplicationInsights.DataContracts;  
using MvcCustomExceptionFilter.CustomFilter;  
   
namespace LIBUser.App_Start
{
    public class FilterConfig
    {
        public static void RegisterGlobalFilter(GlobalFilterCollection filters)
        {
            filters.Add(new CustomExceptionHandlerFilter());
        }
    }
}
				

When you create a project, if you have selected the Empty MVC Template then the FilterConfig class will not be available to you, but if you have selected any ready-mate MVC template then the FilterConfig class will be available within your application. If this file is not available, then just simply create a class file with the name FilterConfig inside the App_Start folder. This FilterConfig class is the place where we used to add the Filters globally for our application. It file will be instantiated when our Web application starts.

Looking for Trusted ASP.Net Development Company For Your Business?

Now Register our CustomExceptionHandlerFilter in the Global. asax


Global.aspx
using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Web;  
using System.Web.Mvc;  
using System.Web.Routing;  
using MvcCustomExceptionFilter.App_Start;  
   
namespace MvcCustomExceptionFilter
{
    public class MvcApplication : System.Web.HttpApplication
    {
        protected void Application_Start()
        {
            FilterConfig.RegisterGlobalFilter(GlobalFilters.Filters);
            AreaRegistration.RegisterAllAreas();
            RouteConfig.RegisterRoutes(RouteTable.Routes);
        }
    }
}
				

Inside the shared folder of view, it contains the Error. cshtml page modifies the Error. cshtml as per your requirement. If the shared folder does not contain an Error. cshtml you can add a view inside the shared folder and place this code inside the error page.

 

@{
    ViewBag.Title = "Error";
}

Error Occured

An unknown error occurred while processing your request.

Open the web. config file and add the custom error mode inside the system. web

 



				

Now run the application and add the details inside the create view.

AddEmployeeDetails

[Fig:- Add Employee Details]

If we can add the salary that is not range to a specific position it will give an error and we will redirect to the Error page instead of yellow screen or exception. Here I insert salary for JuniorForntEndDeveloper 10000 it will get me an error because in code set salary for JuniorForntEndDeveloper between 1000 to 4000.

Exception

[Fig:-Exception]

After click on create button, it gives an Error and redirects to the error page.

Conclusion


Exception filter provides the built-in HandleError attribute but we cannot handle the log error and exceptions that occurs inside the controller class, however, with the help of the custom exception we can handle the errors that occur inside the controller class.

What is Exception Filter and explain custom Exception Filter in ASP.NET MVC? Table of Content 1. What is an Exception Filter? 2. Custom Exception Filter 3. Creating Custom Exception Filter 4. Conclusion What is an Exception Filter? Exception Filter provides an ability to handle the exception for all the method, controller classes in one place. Exception filters execute when some of the exceptions are thrown from an action. The exception can be anything. This is by creating a class that inherits from IExceptionFilter and FileAttribute interface. Custom Exception Filter Exception Filter provides a built-in HandleError attribute to handle exception filter with the built-in attribute we can’t do the following things. Cannot log the Exception using the HandleError attribute It is not possible to handle exception occurs outside the controllers. Exception handling is not possible, depending on the scenario. For Example, one error page when the request comes through AJAX and a different one is a normal request. Let's look at how to work around these problems by creating a custom exception filter. Creating Custom Exception Filter Here I am creating an Employee class for the model inside the model folder. Employee. class using System.ComponentModel.DataAnnotations; using System.ComponentModel.DataAnnotations.Schema; namespace LIBData { public class Employee { public int Id { get; set; } [Required(ErrorMessage = "Name Required")] public string Name { get; set; } [Required(ErrorMessage = " Designation Required ")] public string Designation{ get; set; } [Required(ErrorMessage = "Salary Required ")] public int Salary { get; set; } } } Now we need to add controller class inside the controller folder add. EmployeeController using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Mvc; using LIBUser.CustomFilter; using LIBUser.Models; namespace LIBUser.Controllers { public class EmployeeController: Controller { public EmployeeContext db = new EmployeeContext(); public ActionResult Index() { var employee = db .Employees.ToList(); return View(employee); } public ActionResult Details(int? id) { if (id == null) { return new HttpStatusCodeResult(HttpStatusCode.BadRequest); } Employee employee = db.Employees.Find(id); if (employee == null) { return HttpNotFound(); } return View(employee); } public ActionResult Create() { return View(); } [HttpPost] [CustomExceptionHandlerFilter] public ActionResult Create(Employee employee) { if (ModelState.IsValid) { if (employee.Designation== "JuniorForntEndDeveloper" && (employee.Salary 4000)) { throw new Exception("Salary is not matching with JuniorForntEndDeveloper."); } else if (employee.Designation== "WebDeveloper" && (employee.Salary 40000)) { throw new Exception("Salary is not matching with WebDeveloper."); } else if (employee.Designation== "Marketing Manager") { throw new Exception("Salary is not matching with Marketing Manager"); } else { db .Employees.Add(employee); db .SaveChanges(); } } return RedirectToAction("Index"); } } } Read More: Generate Thumbnail Using Asp.net Mvc Add the following line of code inside the Employee controller. In this example, I will just demonstrate how to use a Custom Exception filter you can change your controller as per the requirements. Now, we need to add the view for Create action method and Index action method. Right-click on create method and add view. Create View @model LIBData.Employee @{ ViewBag.Title = "Create"; Layout = "~/Views/Shared/LibStudent.cshtml"; } Add Employee Details @using (Html.BeginForm()) { @Html.AntiForgeryToken()Employee @Html.ValidationSummary(true, "", new { @class = "text-danger" }) @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" }) @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" }) @Html.LabelFor(model => model.Designation, htmlAttributes: new { @class = "control-label col-md-2" }) @Html.EditorFor(model => model.Designation, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Designation, "", new { @class = "text-danger" }) @Html.LabelFor(model => model.Salary, htmlAttributes: new { @class = "control-label col-md-2" }) @Html.EditorFor(model => model.Salary, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Salary, "", new { @class = "text-danger" }) } @Html.ActionLink("Back to List", "Index") Add the CustomExceptionHandlerFilter class for creating a custom exception handler. Implements FilterAttribute and IExceptionFilter and overrides the OnException method.   using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Mvc; namespace LIBUser.Controllers { public class CustomExceptionHandlerFilter: FilterAttribute, IExceptionFilter { public void OnException(ExceptionContext filterContext) { ExceptionLogger logger = new ExceptionLogger() { ExceptionMessage = filterContext.Exception.Message, ExceptionStackTrack = filterContext.Exception.StackTrace, ControllerName = filterContext.RouteData.Values["controller"].ToString(), ActionName = filterContext.RouteData.Values["action"].ToString(), ExceptionLogTime = DateTime.Now }; EmployeeContext dbContext = new EmployeeContext(); dbContext.ExceptionLoggers.Add(logger); dbContext.SaveChanges(); filterContext.ExceptionHandled = true; filterContext.Result = new ViewResult() { ViewName = "Error" }; } } } Open App_Start folder inside the App_start folder contains FilterConfig class. Inside this class, we add our new CustomExceptionHandlerFilter in the following way.   using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Mvc; using Microsoft.ApplicationInsights.DataContracts; using MvcCustomExceptionFilter.CustomFilter; namespace LIBUser.App_Start { public class FilterConfig { public static void RegisterGlobalFilter(GlobalFilterCollection filters) { filters.Add(new CustomExceptionHandlerFilter()); } } } When you create a project, if you have selected the Empty MVC Template then the FilterConfig class will not be available to you, but if you have selected any ready-mate MVC template then the FilterConfig class will be available within your application. If this file is not available, then just simply create a class file with the name FilterConfig inside the App_Start folder. This FilterConfig class is the place where we used to add the Filters globally for our application. It file will be instantiated when our Web application starts. Looking for Trusted ASP.Net Development Company For Your Business? CONNECT US Now Register our CustomExceptionHandlerFilter in the Global. asax Global.aspx using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Mvc; using System.Web.Routing; using MvcCustomExceptionFilter.App_Start; namespace MvcCustomExceptionFilter { public class MvcApplication : System.Web.HttpApplication { protected void Application_Start() { FilterConfig.RegisterGlobalFilter(GlobalFilters.Filters); AreaRegistration.RegisterAllAreas(); RouteConfig.RegisterRoutes(RouteTable.Routes); } } } Inside the shared folder of view, it contains the Error. cshtml page modifies the Error. cshtml as per your requirement. If the shared folder does not contain an Error. cshtml you can add a view inside the shared folder and place this code inside the error page.   @{ ViewBag.Title = "Error"; }Error Occured An unknown error occurred while processing your request. Open the web. config file and add the custom error mode inside the system. web   Now run the application and add the details inside the create view. [Fig:- Add Employee Details] If we can add the salary that is not range to a specific position it will give an error and we will redirect to the Error page instead of yellow screen or exception. Here I insert salary for JuniorForntEndDeveloper 10000 it will get me an error because in code set salary for JuniorForntEndDeveloper between 1000 to 4000. [Fig:-Exception] After click on create button, it gives an Error and redirects to the error page. Conclusion Exception filter provides the built-in HandleError attribute but we cannot handle the log error and exceptions that occurs inside the controller class, however, with the help of the custom exception we can handle the errors that occur inside the controller class.

Build Your Agile Team

Enter your e-mail address Please enter valid e-mail

Categories

Ensure your sustainable growth with our team

Talk to our experts
Sustainable
Sustainable
 

Blog Our insights

Power Apps vs Power Automate: When to Use What?
Power Apps vs Power Automate: When to Use What?

I often see people asking questions like “Is Power App the same as Power Automate?”. “Are they interchangeable or have their own purpose?”. We first need to clear up this confusion...

Azure DevOps Pipeline Deployment for Competitive Business: The Winning Formula
Azure DevOps Pipeline Deployment for Competitive Business: The Winning Formula

We always hear about how important it is to be competitive and stand out in the market. But as an entrepreneur, how would you truly set your business apart? Is there any way to do...

React 18 Vs React 19: Key Differences To Know For 2024
React 18 Vs React 19: Key Differences To Know For 2024

Ever wondered how a simple technology can spark a revolution in the IT business? Just look at React.js - a leading Front-end JS library released in 2013, has made it possible. Praised for its seamless features, React.js has altered the way of bespoke app development with its latest versions released periodically. React.js is known for building interactive user interfaces and has been evolving rapidly to meet the demands of modern web development. Thus, businesses lean to hire dedicated React.js developers for their projects. React.js 19 is the latest version released and people are loving its amazing features impelling them for its adoption.