{"id":1751,"date":"2023-06-14T08:55:05","date_gmt":"2023-06-14T08:55:05","guid":{"rendered":"http:\/\/waqar-arshad.com\/?p=1751"},"modified":"2023-06-14T08:55:05","modified_gmt":"2023-06-14T08:55:05","slug":"asp-net-core-exception-handling","status":"publish","type":"post","link":"http:\/\/waqar-arshad.com\/index.php\/2023\/06\/14\/asp-net-core-exception-handling\/","title":{"rendered":"Asp.Net Core Exception Handling"},"content":{"rendered":"
\r\n
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div>
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div><\/div>\n

ASP.NET Core – Exception Handling<\/h1>\n\n\n\n

Exception handling is one of the most important features of any application. Fortunately, ASP.NET Core includes a middleware that makes exception handling easy. In this chapter, we will learn about exception handling in ASP.NET Core application.<\/p>\n\n\n\n

By default, ASP.NET Core returns a simple status code for any exception that occurs in an application. Consider the following example of Configure method which throws an error.<\/p>\n\n\n\n

public <\/code>class <\/code>Startup<\/code><\/pre>\n\n\n\n
{<\/code><\/pre>\n\n\n\n
    <\/code>public <\/code>void Configure(<\/code>IApplicationBuilder app, <\/code>IHostingEnvironment env)<\/code><\/pre>\n\n\n\n
    {            <\/code><\/pre>\n\n\n\n
        app.Run(context => { <\/code>throw <\/code>new <\/code>Exception(<\/code>\"error\"); });<\/code><\/pre>\n\n\n\n
    }<\/code><\/pre>\n\n\n\n
}<\/code><\/pre>\n\n\n\n
The above code will display the following result.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/a><\/p>\n\n\n\n
Install Microsoft.AspNetCore.Diagnostics Package<\/h2>\n\n\n\n
To handle exceptions and display user friendly messages, we need to install Microsoft.AspNetCore.Diagnostics<\/code> NuGet package and add middleware in the Configure()<\/code> method. If you are using Visual Studio templates to create ASP.NET Core application then this package might be already installed. If not then you can add Microsoft.AspNetCore.Diagnostics<\/code> package via NuGet manager.<\/p>\n\n\n\n
The Microsoft.AspNetCore.Diagnostics<\/code> package includes following extension methods to handle exceptions in different scenario:<\/p>\n\n\n\n
    \n
  1. UseDeveloperExceptionPage<\/li>\n\n\n\n
  2. UseExceptionHandler<\/li>\n<\/ol>\n\n\n\n
    UseDeveloperExceptionPage<\/strong><\/h3>\n\n\n\n
    The UseDeveloperExceptionPage<\/code> extension method adds middleware into the request pipeline which displays developer friendly exception detail page. This helps developers in tracing errors that occur during development phase.<\/p>\n\n\n\n
    As this middleware displays sensitive information, it is advisable to add it only in development environment.<\/p>\n\n\n\n
    public <\/code>class <\/code>Startup<\/code><\/pre>\n\n\n\n
    {<\/code><\/pre>\n\n\n\n
        <\/code>public <\/code>void Configure(<\/code>IApplicationBuilder app, <\/code>IHostingEnvironment env)<\/code><\/pre>\n\n\n\n
        {<\/code><\/pre>\n\n\n\n
            <\/code>if (env.IsDevelopment() || env.IsStaging())<\/code><\/pre>\n\n\n\n
            {<\/code><\/pre>\n\n\n\n
                app.UseDeveloperExceptionPage();<\/code><\/pre>\n\n\n\n
            }<\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
            app.Run(context => { <\/code>throw <\/code>new <\/code>Exception(<\/code>\"error\"); });<\/code><\/pre>\n\n\n\n
        }<\/code><\/pre>\n\n\n\n
    }<\/code><\/pre>\n\n\n\n
    The above code will display the following result.<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    <\/a>Exception Handling<\/p>\n\n\n\n
    As you can see above, the developer exception page includes 4 tabs: Stack, Query, Cookies, and Headers. Stack tab displays information of stack trace, which indicates where exactly an error occurred. Query tab displays information about query string. Cookies tab displays information about cookies set by the request and Headers tab displays information about headers.<\/p>\n\n\n\n
    UseExceptionHandler<\/strong><\/h3>\n\n\n\n
    In MVC Core application, we might want some other controller to handle all exceptions and display custom user friendly error messages. The UseExceptionHandler<\/code> extension method allows us to configure custom error handling route. This is useful when an application runs under production environment.<\/p>\n\n\n\n
    Example: Exception Handler in MVC<\/p>\n\n\n\n
     Copy<\/p>\n\n\n\n
    public <\/code>void Configure(<\/code>IApplicationBuilder app, <\/code>IHostingEnvironment env)<\/code><\/pre>\n\n\n\n
    {<\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
        <\/code>if (env.IsDevelopment() || env.IsStaging())<\/code><\/pre>\n\n\n\n
        {<\/code><\/pre>\n\n\n\n
            app.UseDeveloperExceptionPage();<\/code><\/pre>\n\n\n\n
        }<\/code><\/pre>\n\n\n\n
        <\/code>else <\/code><\/pre>\n\n\n\n
        {<\/code><\/pre>\n\n\n\n
            app.UseExceptionHandler(<\/code>\"\/Home\/Error\");<\/code><\/pre>\n\n\n\n
        }<\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
        <\/code>\/\/code removed for clarity <\/code><\/pre>\n\n\n\n
    }<\/code><\/pre>\n\n\n\n
    In the above example, the UseExceptionHandler(\"\/Home\/Error\")<\/code> sets the error handler path. If an error occurred in the MVC application then it will redirect the request to \/home\/error<\/code>, which will execute the Error action method of HomeController<\/code>.<\/p>\n\n\n\n
    Create a simple Error action method in HomeController<\/code> class as shown below.<\/p>\n\n\n\n
    HomeController:<\/p>\n\n\n\n
     Copy<\/p>\n\n\n\n
    public <\/code>class <\/code>HomeController : <\/code>Controller<\/code><\/pre>\n\n\n\n
    {<\/code><\/pre>\n\n\n\n
        <\/code>public HomeController()<\/code><\/pre>\n\n\n\n
        {<\/code><\/pre>\n\n\n\n
        }<\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
        <\/code>public <\/code>IActionResult Error()<\/code><\/pre>\n\n\n\n
        {<\/code><\/pre>\n\n\n\n
            <\/code>return View();<\/code><\/pre>\n\n\n\n
        } <\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
        <\/code>\/\/ other code removed for the clarity<\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
    }<\/code><\/pre>\n\n\n\n
    The following is the content of Error.cshtml.<\/p>\n\n\n\n
    Error.cshtml<\/p>\n\n\n\n
     Copy<\/p>\n\n\n\n
    @{<\/code><\/pre>\n\n\n\n
        ViewData[\"Title\"] = \"Error\";<\/code><\/pre>\n\n\n\n
    }<\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
    <h1 <\/code>class=\"text-danger\">Error.<\/code><\/h1><\/code><\/pre>\n\n\n\n
    <h2 <\/code>class=\"text-danger\">An error occurred while processing your request.<\/code><\/h2><\/code><\/pre>\n\n\n\n
     <\/code><\/pre>\n\n\n\n
    <h3>Development Mode<\/code><\/h3><\/code><\/pre>\n\n\n\n
    <p><\/code><\/pre>\n\n\n\n
        Swapping to <\/code><strong>Development<\/code><\/strong> environment will display more detailed information about the error that occurred.<\/code><\/pre>\n\n\n\n
    <\/p><\/code><\/pre>\n\n\n\n
    <p><\/code><\/pre>\n\n\n\n
        <\/code><strong>Development environment should not be enabled in deployed applications<\/code><\/strong>, as it can result in sensitive information from exceptions being displayed to end users. For local debugging, development environment can be enabled by setting the <\/code><strong>ASPNETCORE_ENVIRONMENT<\/code><\/strong> environment variable to <\/code><strong>Development<\/code><\/strong>, and restarting the application.<\/code><\/pre>\n\n\n\n
    <\/p><\/code><\/pre>\n\n\n\n
    Now, when an error occurs, it displays the page shown below.<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    <\/a>Exception Handling<\/p>\n\n\n\n
    Thus, we can configure middleware to handle exceptions in ASP.NET Core application.<\/p>\n\n\n\n
     Note:<\/p>\n\n\n\n
    Visual Studio automatically creates Error.cshtml under Home folder when you create ASP.NET Core project with MVC template.<\/p>\n","protected":false},"excerpt":{"rendered":"
    ASP.NET Core – Exception Handling Exception handling is one of the most important features of any application. Fortunately, ASP.NET Core includes a middleware that makes exception handling easy. In this chapter, we will learn about exception handling in ASP.NET Core application. By default, ASP.NET Core returns a simple status code for any exception that occurs […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[13],"tags":[],"class_list":["post-1751","post","type-post","status-publish","format-standard","hentry","category-asp-net-core"],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false},"uagb_author_info":{"display_name":"admin","author_link":"http:\/\/waqar-arshad.com\/index.php\/author\/waqar_29_1\/"},"uagb_comment_info":20,"uagb_excerpt":"ASP.NET Core – Exception Handling Exception handling is one of the most important features of any application. Fortunately, ASP.NET Core includes a middleware that makes exception handling easy. In this chapter, we will learn about exception handling in ASP.NET Core application. By default, ASP.NET Core returns a simple status code for any exception that occurs…","_links":{"self":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts\/1751","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/comments?post=1751"}],"version-history":[{"count":1,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts\/1751\/revisions"}],"predecessor-version":[{"id":1755,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts\/1751\/revisions\/1755"}],"wp:attachment":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/media?parent=1751"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/categories?post=1751"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/tags?post=1751"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}