Click or drag to resize

PdfIntegrationProviderOnHttpHandlerException Method

Called when an exception occurs in a call to the PdfHttpHandler configured.

Namespace:  RadPdf.Integration
Assembly:  RadPdf (in RadPdf.dll) Version: (
public virtual void OnHttpHandlerException(
	ExceptionEventArgs e


Type: RadPdf.IntegrationExceptionEventArgs
An object (defined by ExceptionEventArgs) that contains event data.

Inheriting classes can override this method to perform other tasks or modify how an exception is logged. If this method is overridden in an inheriting class, you must call the base implementation.

This method is NOT triggered by exceptions which occur outside of the PdfHttpHandler like the PdfDocumentEditor, PdfWebControl, or PdfWebControlLite.

The following example overrides the default PdfIntegrationProvider to create a custom Integration Provider for the web application.
using System;
using System.Web;

using RadPdf.Integration;

public class CustomPdfIntegrationProvider : PdfIntegrationProvider
    public override void OnHttpHandlerException(ExceptionEventArgs e)

        // Prevent RAD PDF from logging this exception
        e.WriteToLog = false;
The following web.config file registers the above custom Integration Provider. This example assumes that CustomPdfIntegrationProvider is in the directory App_Code of your ASP.NET web application.
<?xml version="1.0"?>
    <add key="RadPdfConnectionString" value="Server=.\SQLExpress;Database=RadPdf;Trusted_Connection=Yes;"/>
    <add key="RadPdfLicenseKey" value="DEMO"/>
    <add key="RadPdfIntegrationProvider" value="CustomPdfIntegrationProvider,App_Code"/>
      <add path="RadPdf.axd" verb="GET,POST" type="RadPdf.Web.HttpHandler.PdfHttpHandler"/>
    The system.webServer element is for use with IIS 7 (and later) when Managed Pipeline Mode is set to "Integrated".
    It will be ignored in other versions of IIS.
    <validation validateIntegratedModeConfiguration="false"/>
      <add path="RadPdf.axd" verb="GET,POST" name="PdfHttpHandler" preCondition="integratedMode" type="RadPdf.Web.HttpHandler.PdfHttpHandler"/>
See Also