GemBox Spreadsheet导出Excel为PDF时饼图与原文件显示不一致

问题描述 #

使用GemBox Spreadsheet组件开发Excel转PDF功能时，导出的PDF文件中饼图显示效果和原Excel内的效果存在偏差，效果对比如下：

• 原Excel文件饼图效果：
• 导出PDF的饼图效果：

当前使用的饼图相关实现代码如下：

// 新增饼图
var pieChart = worksheet.Charts.Add(ChartType.Pie, "A27", "G45");
pieChart.SelectData(worksheet.Cells.GetSubrange("G2:G6"), true, true);
pieChart.DataLabels.LabelContainsValue = true;
pieChart.DataLabels.LabelContainsPercentage = true;
pieChart.DataLabels.ShowLeaderLines = true;
pieChart.DataLabels.Separator = ", ";
pieChart.Legend.IsVisible = true;
pieChart.Legend.Position = ChartLegendPosition.Bottom;

var printOptions = worksheet.PrintOptions;
printOptions.FitWorksheetWidthToPages = 1;
printOptions.FitWorksheetHeightToPages = 1;
workbook.Save(ms, SaveOptions.PdfDefault);

解决方案 #

该问题属于组件版本兼容+配置缺失导致的渲染偏差，按以下优先级排查处理：

• 升级组件版本
  旧版GemBox.Spreadsheet对同时显示「数值+百分比」双标签、底部布局图例的饼图存在已知渲染bug，会出现标签错位、扇区配色映射错误、引导线丢失的问题，升级到最新稳定版即可修复大部分基础显示偏差。
• 显式指定图表渲染属性，避免默认值和Excel逻辑不一致
  不要依赖组件的默认自动计算逻辑，手动补充标签位置、字体大小配置，对齐Excel原生的渲染规则：

// 显式指定数据标签位置为最佳适配
pieChart.DataLabels.Position = DataLabelPosition.BestFit;
// 固定标签字体大小，和原Excel文件内字号保持一致，禁止自动缩放
pieChart.DataLabels.Font.Size = 9;

• 调整PDF保存配置，避免缩放导致图表变形
  不要直接使用SaveOptions.PdfDefault默认配置，改用自定义PdfSaveOptions，固定渲染DPI、关闭不必要的格式适配：

var pdfSaveOptions = new PdfSaveOptions
{
    ImageDpi = 300,
    ConformanceLevel = PdfConformanceLevel.None
};
workbook.Save(ms, pdfSaveOptions);

注意：如果你的饼图是提前在Excel模板中预置的，不是通过代码动态生成的，不要在代码中重复调用SelectData、重复设置图例/数据标签属性，代码重复赋值会覆盖原文件中保存的图表自定义样式，直接导致渲染效果和原文件不一致。这类场景下只需要配置打印参数、调用保存方法即可，不要修改已有图表的属性。

内容的提问来源于stack exchange，提问作者Kiattisak Phanphu