Open-Xml-Sdk 3.1.0版本中FontName元素处理变更解析

在Open-Xml-Sdk 3.1.0版本更新后，开发人员可能会遇到一个关于FontName元素处理的变更问题。本文将深入分析这一变更的技术背景、原因以及正确的使用方法。

问题现象

当开发者在RunProperties中添加FontName作为子元素时，该元素会被转换为OpenXmlUnknownElement。这与之前版本的行为有所不同，导致部分现有代码可能无法按预期工作。

技术背景分析

在Open-Xml-Sdk 3.1.0版本中，对元素类型的处理机制进行了重要调整。根据Office Open XML规范，FontName元素（对应XML中的x:name）实际上是用于样式部分中字体集合的定义，而不是用于内联字符串的文本运行属性。

正确的元素使用方式

对于内联字符串的字体设置，应该使用RunFont元素（对应XML中的x:rFont）而非FontName元素。以下是正确的代码示例：

var runProps = new RunProperties();
runProps.AddChild(new RunFont(), throwOnError: true);

版本变更的技术考量

3.1.0版本的这一变更是为了：

1. 更严格地遵循Office Open XML规范
2. 优化AOT（Ahead-Of-Time）编译场景下的性能
3. 减少元素可能保留的不必要引用

开发者应对策略

1. 检查现有代码中所有使用FontName作为RunProperties子元素的情况
2. 将其替换为RunFont元素
3. 使用AddChild方法并设置throwOnError参数为true，以便在添加不合法子元素时获得即时反馈

技术建议

对于需要处理字体名称的场景，开发者应当：

• 在样式部分使用FontName元素
• 在内联文本运行属性中使用RunFont元素
• 充分利用throwOnError参数进行早期错误检测

这一变更虽然可能导致部分现有代码需要调整，但从长远来看有助于提高代码的规范性和可靠性，避免潜在的类型混淆问题。