Excel workbook to PDF¶
Converts an Excel workbook stream to PDF bytes using the Syncfusion ExcelToPdfConverter, optionally at PDF/A-1b conformance.
| Field | Value |
|---|---|
| Operation ID | OP-SFC-004 |
| Trigger | Called by Execute a single conversion (converter template) via ExcelConverter.ConvertItem, dispatched from Convert a source document to PDF for xls/xlsx |
| Inputs | Source Stream, ConvertRequest |
| Outputs | PDF byte[] |
| Primary components | ExcelConverter.ConvertItem |
| Entry point | PdfApi.SyncFusionCore\Convert\ExcelConverter.cs |
Steps¶
- Create
ExcelToPdfConverter(stream)andExcelToPdfConverterSettings. - When
request.Options.IsPdfa, setsettings.PdfConformanceLevel = Pdf_A1B(BR-SFC-011). - Call
converter.Convert(settings), save to aMemoryStream, and return the bytes.
Process flow¶
The following diagram visualizes this operation's control flow.
flowchart TD
Start(["ConvertItem called<br>with stream, request"]) --> Create["Create ExcelToPdfConverter<br>and settings"]
Create --> PdfaCheck{"Options.IsPdfa?"}
PdfaCheck -->|Yes| SetConf["Set PdfConformanceLevel<br>= Pdf_A1B"]
PdfaCheck -->|No| Convert[converter.Convert settings]
SetConf --> Convert
Convert --> Save[Save to MemoryStream]
Save --> Return([Return PDF bytes])
Failure and edge-case behavior¶
- Any Syncfusion conversion failure surfaces as an exception, which is caught by
Execute a single conversion (converter template) and turned into a failed
PdfResultrather than propagated here.
Related documentation¶
Sources¶
PdfApi.SyncFusionCore\Convert\ExcelConverter.cs