Error handling and Logging

Errors in widgets

By default, the ASP.NET Core Renderer catches exceptions thrown by widgets and isolates them on the widget level.

Errors in widget are rendered in following ways:

  • When editing a page - the widget error is displayed in the page editor. 
  • When previewing or viewing a page – the widget does not render any content.

This way, the Renderer does not allow a single widget to break the entire page.

Errors in pages

When in development mode, the ASP.NET Core Renderer takes advantage of the DeveloperExceptionMiddleware that comes automatically included in the pipeline.

Error pages handling

Because the ASP.NET Core Renderer is a standalone application, the error handling is separated from the configuration of Sitefinity CMS. Therefore, any settings for error handling that you make in Sitefinity CMS do not affect the ASP.NET Core pages, only the MVC-based pages. 

Configure error pages 

There are no custom configurations for error pages handling. NET Core Renderer relies on the out-of-the-box implementations of ASP.NET Core for error handling. 

For more information, see Handle errors in ASP.NET Core.

GITHUB EXAMPLE: The Error pages sample, located in Sitefinity GitHub Repository illustrates how to use the following middleware:

  • ErrorHandlerPage
  • UseStatusCodePages

Logging

Sitefinity ASP.NET Core Renderer implements the standard approach for logging in ASP.NET Core.
For more information, see Logging in .NET Core and ASP.NET Core.

GITHUB EXAMPLE: The GitHub sample mentioned above, contains a sample implementation of a third-party logging library - Serilog

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Troubleshooting