HtmlConverter¶

HtmlConverter is the BaseConverter subclass selected by ConverterFactory for .html source files. It renders markup to PDF using Syncfusion's IE-based HTML rendering engine, always with an empty base URL, which means the source markup cannot resolve relative links to external resources such as images or stylesheets.

Purpose¶

Convert HTML markup to PDF via the Syncfusion IE-based HTML converter (BR-SFC-003, BR-SFC-022).
Identify itself to ConverterFactory and downstream consumers as the Html conversion type.

Context¶

Namespace: PdfAPI.SyncFusionCore
Assembly/package: PdfAPI.SyncFusionCore (Pdf.Local.Client NuGet package)

Public members¶

Member	Signature	Purpose
HtmlConverter	`HtmlConverter()`	Creates a ready-to-use `HtmlConverter` instance for `ConverterFactory` to invoke against HTML source documents (`.html`); the constructor body is empty*, so no state is established beyond the base type's fields.
ConversionType	`override SourceConversionType ConversionType { get; }`	Returns `SourceConversionType.Html`, identifying this converter's source format to `ConverterFactory` and to the assembled `PdfResult`.

Inherited public members¶

Members in this section are inherited from BaseConverter in PdfAPI.SyncFusionCore. They are available on this type through inheritance.

Member	Signature	Purpose	Origin
Convert	`PdfResult Convert(Stream stream, ConvertRequest request)`	Executes the full conversion: times the operation, invokes `ConfigureConverter` and `ConvertItem`, and assembles a `PdfResult` with `Status`, `Elapsed`, and `PdfProcessorType = Syncfusion`; captures rather than propagates conversion exceptions (BR-SFC-006, BR-SFC-010).	`PdfAPI.SyncFusionCore` — `BaseConverter`

Behavioral notes¶

The empty base URL used for rendering means relative-path references in the source HTML (e.g. <img src="./logo.png">) will not resolve, and such resources will not appear in the output PDF (BR-SFC-023).
Rendering fidelity is bounded by the Syncfusion IE engine's HTML/CSS support rather than a modern browser engine.
A conversion failure is captured by the inherited Convert method and reported through the result rather than thrown (BR-SFC-010).

Constraints and usage notes¶

Not intended to be constructed directly by application code; ConverterFactory constructs and invokes it based on the source file extension.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts.

Sources¶

PdfApi.SyncFusionCore\Convert\HtmlConverter.cs