How to resolve SpreadProcessing Cross-Platform Differences Due To Limitations
Environment
| Version | Product | Author |
|---|---|---|
| 2026.2.707 | RadSpreadProcessing/RadPdfProcessing | Yoan Karamanov |
Description
In cross-platform projects, you often use RadSpreadProcessing to work with Excel files and use PdfFormatProvider only for Excel to PDF conversion. In this setup, the XLSX result can look correct while the exported PDF result shows clipped text, fallback fonts, or image issues.
This article covers two scenarios:
- Working only with XLSX files through
WorkbookandWorksheetAPIs. - Working with XLSX files and exporting to PDF through
PdfFormatProvider.
Cause
The cross-platform build does not expose OS-specific APIs for automatic font resolution, text measurement, and image processing. Because of this, XLSX processing and PDF export do not use identical rendering paths unless you configure the required extensibility points.
Solution
Apply Configuration Based on the Scenario
Use the following mapping:
| Scenario | Typical Effect | Action |
|---|---|---|
| XLSX import, edit, and export only | Incorrect text fit, width, or row-height calculations in specific layouts | Configure SpreadExtensibilityManager.TextMeasurer |
| XLSX to PDF export | Missing symbols, fallback fonts, clipped text, image export issues, and page layout differences | Configure text measuring, fonts, images, and page setup before export |
Configure Text Measuring for Both Scenarios
Set SpreadExtensibilityManager.TextMeasurer to improve text sizing:
SpreadTextMeasurerBase fixedTextMeasurer = new SpreadFixedTextMeasurer();
SpreadExtensibilityManager.TextMeasurer = fixedTextMeasurer;
Text measuring affects both XLSX-only and XLSX to PDF workflows.
Configure Fonts for Both Scenarios
Set a FontsProviderBase implementation to FixedExtensibilityManager so the exporter can read and embed document fonts:
FontsProviderBase fontsProvider = new FontsProvider();
FixedExtensibilityManager.FontsProvider = fontsProvider;
If fonts are not resolved, the PDF export pipeline falls back to standard PDF fonts and the result differs from the original XLSX file.
When you use
SpreadFixedTextMeasurer, ensure thatFixedExtensibilityManager.FontsProvideris configured. TheSpreadFixedTextMeasurerperforms calcualtions against the used fonts, so if the correct fonts are not provided it falls back to a deafult font and resutls in icorrect calculations and measurements.
Configure Image Processing for XLSX to PDF Export
If the workbook contains images that require conversion or metadata parsing, configure the image extensibility points described in:
Without this setup, export can fail or produce different image output.
Configure Page Setup and PDF Export Settings for XLSX to PDF
Before calling PdfFormatProvider, configure WorksheetPageSetup and PdfExportSettings to control scaling, margins, paper size, and exported range:
WorksheetPageSetup pageSetup = workbook.ActiveWorksheet.WorksheetPageSetup;
pageSetup.FitToPages = true;
pageSetup.FitToPagesWide = 1;
pageSetup.FitToPagesTall = 0;
Handle Known Cross-Platform Limits
Chart export to PDF is not supported in .NET Standard for RadSpreadProcessing. If your workbook depends on chart visuals, use an alternative workflow such as pre-rendering charts outside the PDF export pipeline.
See Also
- SpreadProcessing Cross-Platform Support
- Text Measuring in SpreadProcessing
- Exporting Images in SpreadProcessing Cross-Platform
- PdfProcessing Cross-Platform Support
- Fonts in PdfProcessing Cross-Platform
- Images in PdfProcessing Cross-Platform
- How to Implement a FontsProvider
- Worksheet Page Setup
- How to Eliminate Formatting Issues when Exporting XLSX to PDF Format