Spire.Office 11.11.1 已正式发布。该版本新增了一些功能,如 Spire.XLS 支持 TSV 转 PDF;Spire.Presentation 支持打印幻灯片时保留备注;Spire.PDF 新增 PDF 表单字段与 XFA 表单支持。除此之外,一些在操作 Word、Excel、PDF 和 PPT 文档时出现的问题也已成功被修复。更多新功能及问题修复详情如下。
该版本涵盖了最新版的 Spire.Doc、Spire.PDF、Spire.XLS、Spire.Presentation、Spire.DataExport、Spire.Barcode、Spire.DocViewer、Spire.PDFViewer、Spire.OfficeViewer、Spire.Email。
版本信息如下:
- Spire.Barocde: 7.5.13
- Spire.Doc: 14.11.5
- Spire.DocViewer: 8.11.1
- Spire.Email: 6.8.0
- Spire.OfficeViewer: 9.1.1
- Spire.PDF: 12.11.5
- Spire.PDFViewer: 8.3.4
- Spire.Presentation: 11.11.1
- Spire.Spreadsheet: 7.5.3
- Spire.XLS: 16.10.3
获取 Spire.Office 11.11.1,请点击:
https://www.e-iceblue.cn/Downloads/Spire-Office-NET.html
Spire.Doc
问题修复:
- 修复字符统计结果获取错误的问题。
- 修复 Word 转 PDF 时页眉图片显示不全的问题。
- 修复 Word 转 PDF 时表格位置错乱的问题。
- 修复 Word 转 PDF 过程中抛出 StackOverflowException 异常的问题。
Spire.XLS
新功能:
- 支持将 .tsv 格式文档转换为 PDF。
Workbook workbook = new Workbook();
workbook.LoadFromFile(inputFile, "\t");
workbook.SaveToFile(outputFile, FileFormat.PDF);
workbook.Dispose();
调整:
- 调整了 .NET Core 的打包方式。通过遵循 .NET Standard 规范,实现跨平台兼容性。
- 更新了 .NET 6.0、.NET 9.0 和 .NET 10.0 的相关依赖,并将图像处理从 System.Drawing 迁移至 SkiaSharp。其他平台保持不变。
问题修复:
- 修复了 Excel 转 PDF 时公式计算值更新错误的问题
- 修复了使用 ExportDataTable 导出时,日期列中的字符串值导出为空的问题。
.NET Core 打包及图像处理变更
.NET 6.0、.NET 9.0 和 .NET 10.0 的依赖调整如下,
表中列出的是最低依赖版本。
| 依赖项 | .NET 6.0 | .NET 9.0 | .NET 10.0 |
| SkiaSharp | ≥ 3.116.1 | ≥ 3.116.1 | ≥ 3.116.1 |
| Microsoft.Win32.Registry | ≥ 5.0.0 | ≥ 5.0.0 | ≥ 5.0.0 |
| System.Buffers | ≥ 4.5.1 | ≥ 4.5.1 | ≥ 4.5.1 |
| System.Memory | ≥ 4.5.5 | ≥ 4.5.5 | ≥ 4.5.5 |
| System.Text.Encoding.CodePages | ≥ 6.0.0 | ≥ 9.0.0 | ≥ 10.0.0 |
| HarfBuzzSharp | ≥ 8.3.0.1 | ≥ 8.3.0.1 | ≥ 8.3.0.1 |
图像导出代码迁移
将工作表导出为图像时,ToImage() 的返回结果现在是一个 Stream,
需要将图像流写入文件,而不是直接对返回结果调用 Save()。
- 原使用 System.Drawing 的代码:
- 更新后的代码:
Workbook workbook = new Workbook();
workbook.LoadFromFile(@"in.xlsx");
Worksheet sheet = workbook.Worksheets[0];
sheet.ToImage(sheet.FirstRow, sheet.FirstColumn, sheet.LastRow, sheet.LastColumn).Save("SheetToImage.png");
Workbook workbook = new Workbook();
workbook.LoadFromFile(@"in.xlsx");
Worksheet sheet = workbook.Worksheets[0];
Stream image = sheet.ToImage(sheet.FirstRow, sheet.FirstColumn, sheet.LastRow, sheet.LastColumn);
string filename = String.Format("SheetToImage.png");
FileStream fileStream = new FileStream(filename, FileMode.Create, FileAccess.Write);
image.CopyTo(fileStream, 100);
fileStream.Flush();
fileStream.Close();
image.Close();
Spire.Presentation
新功能:
- 支持打印幻灯片时保留备注。
Presentation ppt = new Presentation();
ppt.LoadFromFile(inputFile);
PresentationPrintDocument document = new PresentationPrintDocument(ppt);
document.PrintSlidesWithNotes = true;
document.PrinterSettings.PrintToFile = true;
document.PrinterSettings.PrintFileName = outputFile;
ppt.Print(document);
调整:
- 调整了 .NET Core 打包方式与依赖关系:.NET Core 通过遵循 .NET Standard 规范实现跨平台兼容性。针对 .NET 6.0、.NET 9.0 和 .NET 10.0,将图片相关处理从 System.Drawing 迁移至 SkiaSharp,并更新了相应的依赖项。
问题修复:
- 修复了加载含批注的 PPTX 文档时,程序抛出 "Comment by nonexistent author" 异常的问题。
- 修复了 PPT 转 PDF,色块未显示的问题。
- 修复了将 PPTX 文档保存为 PPSX 格式时,程序报 "Object reference not set to an instance of an object" 异常的问题。
- 修复了加载 PPTX 文档时,程序报 "Object reference not set to an instance of an object" 异常的问题。
- 修复了 PowerPoint 转 PDF 时图形颜色不正确的问题。
- 修复了 PowerPoint 转 PDF 时内容丢失的问题。
- 修复了 Shape 转 SVG 时多出边框的问题。
- 修复了获取 PowerPoint 文档自定义属性不正确的问题。
.NET Core 打包与图像处理变更说明
针对 .NET 6.0、.NET 9.0 和 .NET 10.0 的依赖项已更新如下,
此处列出的依赖项均为最低版本要求:
| 依赖项 (Dependency) | .NET 6.0 | .NET 9.0 | .NET 10.0 |
| SkiaSharp | ≥ 3.116.1 | ≥ 3.116.1 | ≥ 3.116.1 |
| Microsoft.Win32.Registry | ≥ 5.0.0 | ≥ 5.0.0 | ≥ 5.0.0 |
| System.Buffers | ≥ 4.5.1 | ≥ 4.5.1 | ≥ 4.5.1 |
| System.Memory | ≥ 4.5.5 | ≥ 4.5.5 | ≥ 4.5.5 |
| System.Text.Encoding.CodePages | ≥ 6.0.0 | ≥ 9.0.0 | ≥ 10.0.0 |
| HarfBuzzSharp | ≥ 8.3.0.1 | ≥ 8.3.0.1 | ≥ 8.3.0.1 |
Spire.PDF
新功能:
- 新增 Spire.Pdf.Interactive.Forms 命名空间,支持创建、读取、修改和扁平化 AcroForm 表单字段。
- 新增通过 Spire.Pdf.Interactive.Forms.Xfa 命名空间访问和处理 XFA 表单的功能。
- 新增通过 PdfForm 以 XML、FDF 和 XFDF 格式导入和导出 PDF 表单数据的功能。
调整:
- 修订了 .NET Core 打包方式。通过遵循 .NET Standard 规范实现跨平台兼容性。readme.txt 中针对 .NET 6.0、.NET 9.0 和 .NET 10.0 的依赖项已更新如下;其他平台保持不变:
.NET 6.0 的外部引用:
SkiaSharp >= 3.116.1
Microsoft.Win32.Registry >= 5.0.0
System.Buffers >= 4.5.1
System.Memory >= 4.5.5
System.Text.Encoding.CodePages >= 6.0.0
HarfBuzzSharp >=8.3.0.1
.NET 9.0 的外部引用:
SkiaSharp >= 3.116.1
Microsoft.Win32.Registry >= 5.0.0
System.Buffers >= 4.5.1
System.Memory >= 4.5.5
System.Text.Encoding.CodePages >= 9.0.0
HarfBuzzSharp >=8.3.0.1
.NET 10.0 的外部引用:
SkiaSharp >= 3.116.1
Microsoft.Win32.Registry >= 5.0.0
System.Buffers >= 4.5.1
System.Memory >= 4.5.5
System.Text.Encoding.CodePages >= 10.0.0
HarfBuzzSharp >=8.3.0.1
对于 .NET 6.0、.NET 9.0 和 .NET 10.0,图像处理逻辑已从 System.Drawing 迁移至 SkiaSharp,相关代码修改如下:
使用 System.Drawing 的原始实现:
using (Image image = doc.SaveAsImage )
{ image.Save(fileName, System.Drawing.Imaging.ImageFormat.Png); }
使用 SkiaSharp 的新实现:
using (var image = doc.SaveAsImage )
{ string filename = String.Format(outputFile + i + ".png"); System.IO.FileStream fileStream = new
System.IO.FileStream(fileName, System.IO.FileMode.Create, System.IO.FileAccess.Write);
image.CopyTo(fileStream); fileStream.Flush(); }
优化:
- 废除了合并PDF 的AppendPage接口,请使用下面方式合并:
- 命名空间 Spire.Pdf.Multiimedia._3DArtwork 已重命名为 Spire.Pdf.Multiimedia.Artwork3D。
- XfaNumericField.Value 属性的类型已由 decimal 调整为 double。
MergeOptions option= new MergeOptions();
PdfMerger.Merge(new string[] { file1, file2, file2, file2 }, output, option);
问题修复:
- 修复了合并文档后添加内容(批注或文本)时文档中的链接丢失的问题。
- 修复了将 OFD 转换为 PDF 时抛出内存不足错误 "System.OutOfMemoryException" 的问题。
- 修复了将 PDF 转换为 Excel 后旋转文本的字体变小的问题。
- 修复了按矩形区域提取文本时提取的文本出现重复的问题。
- 修复了将 XPS 转换为 PDF 后在 Adobe Reader 中放大查看时图片消失的问题。
- 修复了获取数字证书为 null 的问题。
- 修复了合并多个 PDF 文档后,后续页面的表单域及样式丢失的问题。
- 修复了 PDF 转 Word 下划线位置偏移的问题。
- 修复了填充 XFA 表单域时,除第一个域外,其他域均无法填充、始终为空的问题。
- 修复了 PDF 文档包含多个签名时,第一个签名的有效性验证失败的问题。
- 修复了加载 PDF 文档时程序报 "NullReferenceException" 异常的问题。
- 修复了填充 XFA 域时,部分字段填充失败的问题。
- 修复了 PDF 转 Word 时字体发生变化的问题。
- 修复了打印 PDF 时部分内容丢失的问题。
- 修复了 PDF 转 Word 后生成的文件无法打开的问题。
1. 新增 Spire.Pdf.Interactive.Forms 命名空间
新版本新增 Spire.Pdf.Interactive.Forms 命名空间,为 PDF 表单域的创建、读取、修改与导出提供一套统一、完整的 API。 覆盖 AcroForm 的常见字段类型,各字段的关键属性与方法如下。
支持的 AcroForm 表单字段类型
| 字段类型 | 属性 / 方法 | 说明 |
| 文本字段 PdfTextField | IsMultiline | 是否允许多行输入 |
| IsPassword | 以掩码显示(密码字段) | |
| MaxLen | 允许输入的最大字符数 | |
| IsComb | 使用字符格子逐格输入 | |
| DoNotSpellCheck | 禁用拼写检查 | |
| Text | 字段的文本内容 | |
| Font | 字段字体 | |
| 复选框 PdfCheckBoxField | IsChecked | 当前是否选中 |
| OnValue | 选中状态对应的导出值 | |
| Style | 视觉样式(Check/Circle/Cross/Diamond/Square/Star) | |
| 单选按钮 PdfRadioButtonField | Options | 各选项的导出值集合 |
| SelectedIndex | 当前选中项的索引 | |
| SelectedValue | 当前选中项的导出值 | |
| NoToggleToOff | 选中后是否禁止取消选择 | |
| AddOption() | 向页面添加一个新的单选选项 | |
| 组合框 PdfComboBoxField | Items | 下拉选项集合 |
| IsMultiSelect | 是否允许多选 | |
| SelectedIndex | 当前选中项的索引 | |
| SelectedValue | 当前选中项的导出值 | |
| CascadeTo() | 与另一个组合框建立 JavaScript 级联 | |
| 列表框 PdfListBoxField | Items | 列表选项集合 |
| IsMultiSelect | 是否允许多选 | |
| TopIndex | 首个可见列表项的索引 | |
| SelectedIndices | 选中项的索引集合 | |
| SelectedValues | 选中项的导出值集合 | |
| 推送按钮 PdfPushButtonField | Text / RolloverText / DownText | 正常 / 悬停 / 按下状态的按钮文字 |
| Icon / RolloverIcon / DownIcon | 对应三种状态的显示图标 | |
| Layout | 图标与文字的排布方式 | |
| Action | 单击按钮时执行的动作 | |
| 签名字段 PdfSignatureField | Signature | 与字段关联的数字签名对象 |
除上述各字段专有的成员外,所有字段还继承自 PdfField 的通用属性,包括:
- IsReadOnly:指定字段是否为只读。
- IsRequired:指定字段是否为必填项。
- AlternateName:获取或设置字段的替代名称。
- MappingName:获取或设置字段的映射名称。
- DefaultAppearance:获取或设置字段的默认外观。
所有字段还可以调用 Flatten() 方法,将表单字段扁平化为静态页面内容。
2. 延伸支持 XFA 表单
在 Spire.Pdf.Interactive.Forms.Xfa 子命名空间下,新版同时提供 XFA 表单访问能力。常见的 XFA 字段类型及其属性如下。
支持的 XFA 表单字段类型
| 字段类型 | 属性 / 方法 | 说明 |
| XFA 表单 XfaForm | FieldNames | 表单模板中的字段名称列表 |
| XfaFields | 表单模板中的字段对象列表 | |
| Count | 表单字段数量 | |
| GetField(name) | 按名称获取 XFA 字段 | |
| CheckFieldExists(name) | 判断指定字段是否存在 | |
| 文本 XfaTextField | Value | 字段的文本值 |
| 数值 XfaNumericField | Format | 数值格式字符串 |
| Value | 字段数值(decimal) | |
| 复选框 XfaCheckBoxField | IsChecked | 当前是否选中 |
| 单选按钮 XfaRadioButtonField | Options | 各选项的导出值列表 |
| SelectedIndex | 当前选中项的索引 | |
| SelectedValue | 当前选中项的导出值 | |
| NoToggleOff | 选中后是否禁止取消选择 | |
| 选择列表 XfaChoiceField | Items | 可选项(显示值)列表 |
| IsMultiSelect | 是否支持多选 | |
| SelectedItem | 当前选中的单项 | |
| SelectedItems | 当前选中的项目列表 | |
| 日期时间 XfaDateTimeField | Value | 字段的日期 / 时间值 |
| 图像 XfaImageField | Image | 字段的图像(Stream / Image) |
| 条码 XfaBarcodeField | Value | 条码值 |
| Length | 条码长度 | |
| StartChar | 条码起始字符 | |
| EndChar | 条码结束字符 |
所有 XFA 字段均继承自 XfaField 的通用属性,包括:
- Name:字段名称。
- XfaForm:字段所属的 XFA 表单。
- FieldType:字段类型标识。
其中,XfaSignatureField(签名字段)和 XfaPushButtonField(推送按钮)未定义额外的公共属性,主要通过上述通用成员访问。
3. 新增表单数据导入和导出功能
PdfForm 现已支持在 XML、FDF、XFDF 三种格式之间导入与导出表单数据。这项功能便于在 PDF 表单、业务系统和第三方 PDF 工具之间交换数据。
代码示例:
using System.Drawing;
using System.Collections.Generic;
using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.Interactive.Forms;
PdfDocument doc = new PdfDocument();
PdfPageBase page = doc.Pages.Add();
// 新命名空间下通过 PdfForm.Create() 获取表单容器
PdfForm form = PdfForm.Create(doc);
// 创建文本字段并添加到页面
PdfTextField nameField = new PdfTextField(form, "Address.Street");
nameField.DefaultAppearance = new PdfDefaultAppearance(
new PdfFont(PdfFontFamily.Helvetica, 12), new PdfRGBColor(0, 0, 0));
nameField.AddWidget(page, new RectangleF(100, 100, 250, 30));
nameField.Value = "123 Main St";
// 按名称与前缀检索字段
PdfField field = form.GetField("Address.Street");
List<PdfField> addressFields = form.Fields.FindByPrefix("Address");
// 拍平为静态内容并保存
form.Flatten();
doc.SaveToFile("output.pdf");
表单数据也可直接以 XFDF 等格式互通:
// 导出表单数据为 XFDF,并从文件回填
form.ExportData("form.xfdf", DataFormat.XFDF, "PurchaseOrder");
form.ImportData("form.xfdf", DataFormat.XFDF);
Spire.PDFViewer
调整:
- 将 .NET 6.0 目录中 Spire.PdfViewer.Forms.dll 的 System.Drawing.Common >= 6.0.0 依赖替换为 SkiaSharp >= 3.116.1。







