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:  RadPdfStandard (in RadPdfStandard.dll) Version: 4.2.0.0 (4.2.0.0)
Syntax
Copy
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#
Copy
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 Program.cs file registers the above custom Integration Provider. This example assumes that CustomPdfIntegrationProvider is in namespace referenced by your ASP.NET web application.
C#
Copy
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

using RadPdf;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddSession();

// Setup WebApplication
var app = builder.Build();
app.UseStaticFiles();
app.UseRouting();
app.UseSession();
app.UseAuthorization();

// Or however you normally process page requests
app.MapRazorPages();

// Create middleware settings
RadPdfCoreMiddlewareSettings settings = new RadPdfCoreMiddlewareSettings()
{
    // Add SQL Server Connection String, if not using Lite Documents
    // Sample connection string below connects to a SQL Server Express instance on localhost
    // TrustServerCertificate=True is set to avoid a trust exception (e.g. "The certificate chain was issued by an authority that is not trusted.")
    // ConnectionString = @"Server=.\SQLExpress;Database=RadPdf;Trusted_Connection=Yes;TrustServerCertificate=True;",

    // Add License Key
    LicenseKey = "DEMO",

    // Attach the Integration Provider
    IntegrationProvider = new CustomPdfIntegrationProvider()

    // To run RAD PDF without the System Service, add UseService = false
    // If using Lite Documents without the System Service, a LiteStorageProvider must also be implemented
    //UseService = false
};

// Add RAD PDF's middleware to app
app.UseRadPdf(settings);

app.Run();
See Also