Skip to content

Register the Syncfusion runtime license

Registers the embedded Syncfusion license key with the Syncfusion runtime. Must run once per process before any Syncfusion API is used by any converter, extractor, or merge operation in this library.

Field Value
Operation ID OP-SFC-015
Trigger PdfAPI\Global.asax.cs:21 (Application_Start) and each test fixture setup
Inputs none
Outputs none (side effect: process-wide license registration)
Primary components LicenseHelper.LicenseSyncfusion
Entry point PdfApi.SyncFusionCore\LicenseHelper.cs

Steps

  1. Pass a hard-coded multi-key license string (embedded in source, commented as licensed to andmil@saif.com for version 17.4) to Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense (BR-SFC-039).

Process flow

The following diagram visualizes this operation's control flow.

flowchart TD
    Start(["LicenseSyncfusion called<br>at Application_Start"]) --> Register["RegisterLicense with<br>embedded key string"]
    Register --> Done(["Syncfusion runtime<br>licensed for this process"])

Failure and edge-case behavior

  • The embedded key is annotated for Syncfusion version 17.4 while the project builds against 18.3; whether the key remains valid for the 18.3 runtime — and what happens if it does not (watermark vs. exception) — cannot be determined from source.**
  • Every operation in this library that invokes the Syncfusion SDK depends on this operation having already run once in the current process; this library does not itself verify or enforce that ordering.

Note: Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

  • PdfApi.SyncFusionCore\LicenseHelper.cs
  • PdfAPI\Global.asax.cs