Click or drag to resize

PdfAdvancedSettingsUseService Property

Gets or sets a value representing whether instances are allowed to use the RAD PDF System Service for rendering pages, prints, and text.

Namespace:  RadPdf.Integration
Assembly:  RadPdf (in RadPdf.dll) Version: 3.23.0.0 (3.23.0.0)
Syntax
public bool UseService { get; set; }

Property Value

Type: Boolean
Remarks

The default value is true.

Some implementations (e.g. running on Azure App Services / Web Services) may want to run RAD PDF without the System Service). Set this to false to prevent errors arising from implementations without the System Service or to prevent unnecsssary calls to the System Service when using RenderAtClient (or RenderAtClient)

If UseService is false, AllowHttpHandlerRendering is true (default), and RenderAtClient is false (default or when using unsupported browsers), RAD PDF will render pages and text using the HttpHandler instead of the System Service.

If UseService is false and using Lite Documents (e.g. PdfWebControlLite), a custom PdfLiteStorageProvider should also be implemented to store data without the RAD PDF System Service.

Examples
The following example overrides the default PdfIntegrationProvider to create a custom Integration Provider for the application does not use the System Service.
C#
using System;
using System.Web;

using RadPdf.Integration;

public class CustomPdfIntegrationProvider : PdfIntegrationProvider
{
    public CustomPdfIntegrationProvider() : base()
    {
        // Set the not to use the RAD PDF System Service
        this.AdvancedSettings.UseService = 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
<?xml version="1.0"?>
<configuration>
  <appSettings>
    <add key="RadPdfConnectionString" value="Server=.\SQLExpress;Database=RadPdf;Trusted_Connection=Yes;"/>
    <add key="RadPdfLicenseKey" value="DEMO"/>
    <add key="RadPdfIntegrationProvider" value="CustomPdfIntegrationProvider,App_Code"/>
  </appSettings>
  <system.web>
    <httpHandlers>
      <add path="RadPdf.axd" verb="GET,POST" type="RadPdf.Web.HttpHandler.PdfHttpHandler"/>
    </httpHandlers>
  </system.web>
  <!--
    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.
    -->
  <system.webServer>
    <validation validateIntegratedModeConfiguration="false"/>
    <handlers>
      <add path="RadPdf.axd" verb="GET,POST" name="PdfHttpHandler" preCondition="integratedMode" type="RadPdf.Web.HttpHandler.PdfHttpHandler"/>
    </handlers>
  </system.webServer>
</configuration>
See Also