Click or drag to resize

PdfIntegrationProviderPdfWebControlResources Property

Gets or sets a ResourceManager used by the PdfWebControl for visible resources (e.g. text strings used in the interface).

Namespace:  RadPdf.Integration
Assembly:  RadPdfStandard (in RadPdfStandard.dll) Version: 4.2.0.0 (4.2.0.0)
Syntax
Copy
public ResourceManager PdfWebControlResources { get; set; }

Property Value

Type: ResourceManager
A ResourceManager that contains resources by the PdfWebControl.
Remarks

This property can be used to customize or localize the appearance of PdfWebControl instances. For example, string resources can be set in the language of your choice, providing a localized RAD PDF GUI (graphical user interface). For additional assistance with localization of RAD PDF, please contact Red Software.

By default, the internal control resources are used (if this property is null or the set ResourceManager does not contain a needed value).

The value of this property is typically only retrieved when the application is starting. To increase performance, information passed to it is cached server-side until the application is restarted and is cached client-side until deleted.

Multiple resource files specifying information for multiple cultures / languages / localizations can be used. In such a case, the culture to use for any PdfWebControl instance is specified with the CultureName property. For example, a web application's App_GlobalResources or App_LocalResources folder can contain resource files named CustomResources.resx (to be used as the default / fallback locale) and CustomResources.es.resx (to be used when CultureName is set to the name of a culture using Spanish, e.g. "es" or "es-MX").

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

using RadPdf.Integration;

public class CustomPdfIntegrationProvider : PdfIntegrationProvider
{
    public CustomPdfIntegrationProvider() : base()
    {
        //Set the PdfWebControl's resources using a resource file in this web application's App_GlobalResources or App_LocalResources folder named CustomResources.resx
        this.PdfWebControlResources = Resources.CustomResources.ResourceManager;
    }
}
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