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.13.5.0 (3.13.5.0)
Syntax
public bool UseService { get; set; }

Property Value

Type: Boolean
Remarks

The default value is true.

Some implementations (e.g. running on Azure Web Services) may want to run RAD PDF without the System Service, relying on RenderAtClient (or RenderAtClient). Set this to false to prevent errors arising from implementations without the System Service.

Setting this property to false may break some RAD PDF functionalities and should only be used if both RenderAtClient (or RenderAtClient) is true and document storage is configured.

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