Spire.Doc Version:14.10.9 对比14.9.11旧版本升级变更明细

摘要

本次升级包含多项高风险的公开 API 变更，其中 DocumentObjectType 枚举的整体重编号会在不重新编译的情况下造成静默的行为错误，是最高风险项。

• 必须全量重新编译所有引用 Spire.Doc 的项目；仅替换 DLL 会导致 MissingMethodException、TypeLoadException，或因枚举常量内联而静默使用错误数值。
• Permission 的标识从 string 改为 int，涉及构造函数、Id、集合查找/索引器、Paragraph.AppendPermStart/End。
• SDT（结构化文档标签）模型重构：SDTContent/SDTInlineContent 删除，SDT Row/Cell 不再是 TableRow/TableCell，丢失大量表格能力。
• 集合体系重构：DocumentObjectCollection 由抽象变具体且更换基类，DocumentSubsetCollection 删除，多个集合更换基类，Add 的返回类型由 int 改为 void。
• 19 个类型的基类发生变化，导致成员上移/下移；ChildObjects/FirstChild/LastChild/GetIndex 从 DocumentObject 下移到 CompositeDocumentObject。
• 统计：公开类型 508 → 507（+8 / -9），公开成员 5460 → 5527（+178 / -111 / ~97）。67 个类型共丢失 250 个有效成员槽，去重后为 90 个唯一签名；114 个类型的元数据发生变化。

1. 比较对象与文件信息

两个版本的引用程序集列表完全一致（HarfBuzzSharp、mscorlib、System、System.Core、System.Data、System.Drawing、System.Web、System.Windows.Forms、System.Xml），未新增或移除程序集依赖。

注意：程序集版本号已变化。.NET Framework 的强名称绑定不会自动接受更高版本；未配置 bindingRedirect 时，旧应用可能在加载阶段就失败。

2. 统计总览

口径说明：

• “公开成员”指 BindingFlags.Public | DeclaredOnly 导出的成员，不含继承成员；构造函数只统计公开构造函数。
• “有效成员面”指沿程序集内基类链向上合并后的可访问成员（构造函数不继承）。
• “成员槽”会在多个类型上重复计数；同一签名影响多个类型时只算一个唯一签名。
• 修改分类可重叠（例如一个成员同时有返回类型与参数名变化）。

3. 最高优先级破坏性变更

3.1 DocumentObjectType 枚举整体重编号（最高风险：静默错误）

旧版本 64 个常量，新版本 62 个：删除 4 个 SDT content 常量，新增 2 个 SDT Mark 常量，并且几乎所有常量的数值都变了。

完整映射表（仅列出变化项）

旧版本完整数值序列

Document=0, Section=1, Body=2, HeaderFooter=3, Paragraph=4, StructureDocumentTag=5, StructureDocumentTagInline=6, StructureDocumentTagRow=7, StructureDocumentTagCell=8, SDTBlockContent=9, SDTInlineContent=10, SDTRowContent=11, SDTCellContent=12, Table=13, TableRow=14, TableCell=15, TextRange=16, Picture=17, FieldStart=18, Field=19, FieldMark=20, FieldSeparator=21, FieldEnd=22, MergeField=23, SeqField=24, EmbededField=25, ControlField=26, TextFormField=27, DropDownFormField=28, CheckBox=29, BookmarkStart=30, BookmarkEnd=31, MoveFromRangeStart=32, MoveFromRangeEnd=33, MoveToRangeStart=34, MoveToRangeEnd=35, PermissionStart=36, PermissionEnd=37, Shape=38, ShapeGroup=39, ShapeLine=40, ShapePath=41, ShapeRect=42, Comment=43, Footnote=44, TextBox=45, Break=46, Symbol=47, TOC=48, XmlParaItem=49, Undefined=50, CommentMark=51, OleObject=52, CustomXml=53, SmartTag=54, OfficeMath=55, System=56, Ruby=57, SubDocument=58, SpecialChar=59, GlossaryDocument=60, BuildingBlock=61, FormField=62, Any=63

新版本完整数值序列

Undefined=-2, System=-1, Any=0, Document=1, Section=2, Body=3, HeaderFooter=4, Paragraph=5, StructureDocumentTag=6, StructureDocumentTagMarkStart=7, StructureDocumentTagMarkEnd=8, StructureDocumentTagInline=9, StructureDocumentTagRow=10, StructureDocumentTagCell=11, Table=12, TableRow=13, TableCell=14, TextRange=15, Picture=16, FieldStart=17, Field=18, FieldMark=19, FieldSeparator=20, FieldEnd=21, MergeField=22, SeqField=23, EmbededField=24, ControlField=25, TextFormField=26, DropDownFormField=27, CheckBox=28, BookmarkStart=29, BookmarkEnd=30, MoveFromRangeStart=31, MoveFromRangeEnd=32, MoveToRangeStart=33, MoveToRangeEnd=34, PermissionStart=35, PermissionEnd=36, Shape=37, ShapeGroup=38, ShapeLine=39, ShapePath=40, ShapeRect=41, Comment=42, Footnote=43, TextBox=44, Break=45, Symbol=46, TOC=47, XmlParaItem=48, CommentMark=49, OleObject=50, CustomXml=51, SmartTag=52, OfficeMath=53, Ruby=54, SubDocument=55, SpecialChar=56, GlossaryDocument=57, BuildingBlock=58, FormField=59

为什么这是最高风险：C# 编译器会把 const 枚举值内联到调用方程序集中。已有程序集不会在运行时重新读取新 DLL 的枚举值，而是继续使用编译时的旧数字。例如：

此外，default(DocumentObjectType) 的含义从 Document 变成了 Any。任何依赖默认值、数值比较、序列化/反序列化、数据库存储或缓存的代码都必须迁移。

处置：

1. 所有消费者必须针对新 DLL 重新编译，不能只替换 DLL。
2. 清理代码中的数字字面量（如 (DocumentObjectType)4），改用常量名。
3. 如果曾把枚举数值持久化，按“旧常量名 → 新常量名”建立映射后重新取新值，不能按数值直接沿用。
4. 检查 switch 是否覆盖了新值；旧值 63（Any）在新版本没有对应成员。

3.2 Permission 标识从 string 改为 int

迁移示例：

// 旧写法
var start = new PermissionStart(doc, "editor-1");
var permission = new Permission(start);
string id = permission.Id;
var found = doc.Permissions.FindById("editor-1");
var byKey = doc.Permissions["editor-1"];       // 旧版索引器
doc.Permissions.Remove(byKey);                  // 旧版按对象删除

// 新写法
var start = new PermissionStart(doc, 1);
var permission = start.Permission;            // 不再有公开构造函数
int id = permission.Id;
permission.Editor = "editor-1";               // 新增的字符串标识
var found = doc.Permissions.FindById(1);
doc.Permissions.Remove(1);                     // 新增按 id 删除

如果业务层原本用字符串做权限主键，需要决定新的整数 ID 分配规则（例如数据库自增、文档内序号），并保证 PermissionStart、PermissionEnd、Permission 三处使用同一个整数。

3.3 SDT（结构化文档标签）模型重构

移除的类型：Spire.Doc.Documents.SDTContent（基类 Body）、Spire.Doc.Documents.SDTInlineContent（基类 DocumentObject）。

新增的类型：StructureDocumentTagMarkStart、StructureDocumentTagMarkEnd（均直接继承 ParagraphBase，仅公开 DocumentObjectType）。

结构变化：

Row 的构造方式：StructureDocumentTagRow(Table ownerTable) 移除，新增 StructureDocumentTagRow(Document doc)。 Cell 的构造方式：StructureDocumentTagCell(TableRow ownerRow) 移除，新增 StructureDocumentTagCell(Document doc)。

影响：任何把 SDT 行/单元格当普通表格行/单元格使用的代码（样式、行高、单元格宽度、合并、拆分、XHTML 插入、Table.Rows/Table.Cells 遍历）都会编译失败或在运行时不再把它们识别为表格结构。新版本把它们改成“带子节点的复合对象”，需要通过 CompositeDocumentObject 的 DOM API（ChildObjects、AppendChild、InsertBefore 等）访问内容。这是一次语义级重构，不能仅靠类型转换解决。

迁移示例：

// 旧写法
StructureDocumentTag sdt = new StructureDocumentTag(doc);
SDTContent content = sdt.SDTContent;
content.AddParagraph();

// 新写法
StructureDocumentTag sdt = new StructureDocumentTag(doc);
IBody body = sdt.Body;
body.AddParagraph();

// 旧写法：SDT 单元格作为 TableCell
StructureDocumentTagCell cell = new StructureDocumentTagCell(row);
cell.CellFormat.Width = 100;

// 新写法：不再有 CellFormat；改用 CompositeDocumentObject 子节点/子内容 API
StructureDocumentTagCell cell = new StructureDocumentTagCell(doc);
// 具体单元格格式需通过子节点或重新设计文档结构实现，需回归验证

3.4 集合体系重构

核心变化：

• DocumentObjectCollection 从 abstract 变为非抽象，基类由 DocumentItemCollectionBase 改为 OwnerHolder；公开构造函数数量为 0（导出结果中没有公开构造函数），主要通过属性返回。
• DocumentSubsetCollection 及其嵌套 SubSetEnumerator 被删除。
• DocumentObjectCollection.Add 的返回类型由 int 改为 void。
• DocumentObjectCollection 新增以 DocumentObject 为参数的强类型重载；原有 IDocumentObject 重载保留但参数名改为 documentObject。
• SectionCollection 不再有公开构造函数；IWSectionCollection 删除，改为空的标记接口 ISectionCollection。

基类变化一览（集合相关）：

Add 返回 int → void 的成员（二进制破坏）：

• DocumentObjectCollection.Add(IDocumentObject)
• ParagraphCollection.Add(IParagraph)
• TableCollection.Add(ITable)
• IParagraphCollection.Add(IParagraph)
• ITableCollection.Add(ITable)
• TableCollection.Insert(int, ITable) 同时由 int 改为 void

迁移示例：

// 旧写法：依赖返回的索引
int index = body.ChildObjects.Add(paragraph);
int index2 = body.Paragraphs.Add(paragraph);

// 新写法：Add 返回 void，需要索引时自行 IndexOf
body.ChildObjects.Add(paragraph);
int index = body.ChildObjects.IndexOf(paragraph);
body.Paragraphs.Add(paragraph);
int index2 = body.Paragraphs.IndexOf(paragraph);

// 旧写法：强类型重载
row.Cells.Add(cell);
table.Rows.Insert(0, row);

// 新写法：使用 DocumentObject 重载（返回 void）
row.Cells.Add((DocumentObject)cell);
table.Rows.Insert(0, (DocumentObject)row);

3.5 基类变化（19 个类型）

基类变化会同时影响继承成员、is/as 转换、重写、序列化和二进制成员解析。

重点影响：

• Comment、Footnote → InlineBody：两者现在都是“内联正文”，具备 AddParagraph/AddTable、CharacterFormat、修订属性；但失去 ParagraphBase 上的一部分旧能力（如 ApplyCharacterFormat、ToString(string)）。
• OfficeMath、ShapeBase → CompositeDocumentObject：形状/公式现在拥有子节点与正文能力，但不再继承 ParagraphBase。
• TableOfContent → Field：TOC 现在是域，获得 IField/ITextRange 及域相关能力。
• StructureDocumentTagRow/Cell → CompositeDocumentObject：不再是表格行/单元格（见 3.3）。
• ShapeItemCollection 的基类“反向”改回 DocumentItemCollectionBase，丢失集合操作（见 3.4）。

3.6 基类成员下移与级联丢失

以下成员从 DocumentObject 下移到 CompositeDocumentObject：

• ChildObjects
• FirstChild
• LastChild
• GetIndex(IDocumentObject)

结果是：复合类型（Body、Section、Table、TableRow、TableCell、Document、Paragraph、Comment、Footnote、形状等）仍可通过新基类访问；但 DocumentObject 本身以及 24 个非复合叶子类型（BookmarkStart/End、Break、Field、TextRange、Symbol、PermissionStart/End、水印类型等）不再暴露这些成员。

说明：ToString(string) 在 48 个类型上消失，是因为它从 DocumentObject 基类被移除；ApplyCharacterFormat 在 11 个类型上消失，是因为这些类型不再继承 ParagraphBase（ParagraphBase 本身仍保留该方法）。

二进制影响：成员上移到基类通常仍能解析（CLR 会沿基类链查找）；成员下移到派生类则不同——旧 IL 中的成员引用通常指向原声明类型 DocumentObject，CLR 不会向派生类查找，替换 DLL 后很可能抛 MissingMethodException。因此“仍可通过新基类访问”只对重新编译后的源码成立，不能据此认为旧二进制安全。

3.7 返回类型变化（21 项）

模式总结：

• Body → IBody（7 项）：BodyRegion.OwnerTextBody、Comment.Body、Footnote.Body、TextBox.Body、ITextBox.Body、FixedLayoutColumn.Body、TextBodySelection.TextBody。
• ParagraphBase → IParagraphBase（4 项）：ParagraphItemCollection 索引器、Paragraph 索引器、IParagraph 索引器、Document.CreateParagraphItem。
• int → void（6 项）：集合 Add/Insert（见 3.4）。
• string → int（3 项）：Permission/PermissionStart/PermissionEnd 的 Id。
• TextBox → ShapeObject（1 项）：TextBoxCollection 索引器。
• 另有 2 项“跨继承替代”导致签名变化，未计入上面的同键修改：DocPicture.Rotation（float → double，旧成员隐藏基类同名属性，新版本改为继承 ShapeBase）、HeadersFooters.GetEnumerator（IEnumerator → IEnumerator<DocumentObject>）。这两项同样会破坏旧二进制。

这些变化都会改变 CLR 方法签名（返回类型是签名的一部分），旧二进制会 MissingMethodException；源码层面通常需要显式转换或改用接口。

3.8 类型移除与命名空间迁移

移除的 9 个公开类型：

新增的 8 个公开类型：

重点：

• Spire.Doc.CompoundFile.IDocCloneable → Spire.Doc.Interface.IDocCloneable。接口身份（Type identity）变化，显式引用旧命名空间的代码会编译失败；反射按全名查找也会失败。
• IWSectionCollection → ISectionCollection。新接口是空标记接口（0 个声明成员），成员来自 ICollectionBase/IDocumentObjectCollection。SectionCollection 实现了新接口。
• ITextBoxItemCollection 在旧版本中没有任何公开实现者，也未出现在任何公开成员签名中，实际影响很小，但仍是公开类型删除。
• DocumentObjectCollection+ChangeItems/ChangeItemsType 是公开嵌套委托/枚举，随集合体系重构删除；未发现对应的公开事件成员，影响有限。

4. 其他破坏性与行为变化

4.1 构造函数与参数类型变化

参数名称变化（仅影响命名实参，源码一般兼容）：

• DocumentObjectCollection.Add/Contains/IndexOf/Insert/Remove：entity → documentObject
• Bookmark(BookmarkStart, BookmarkEnd)：start/end → bookmarkStart/bookmarkEnd
• FormFieldCollection.ContainsName：itemName → formFieldName
• CompositeDocumentObject.IndexOf：docObject → child

4.2 直接声明移除的成员（54 项）

这里统计的是旧类型自身声明的成员在新版本中被移除；不包含“旧类型因基类变化而丢失的继承成员”。后者计入有效成员面（67 个类型共 250 个槽），典型如 ChildObjects、ToString(string)、ApplyCharacterFormat 的级联消失。

完整清单见附录 D。其中最需要关注的非级联项：

另有 2 项：旧声明被基类同名成员取代，但签名发生变化

DocPicture.Rotation 在旧版本中以 float 隐藏了 ShapeBase.Rotation（double）；新版本删除该隐藏声明，因此 DocPicture.Rotation 现在解析为 double。依赖 float 的源码需要显式转换，旧二进制会因返回类型不匹配而失败。

此外，CellCollection/RowCollection 的强类型 Add/IndexOf/Insert/Remove 被移除，但基类 DocumentObjectCollection 仍提供 DocumentObject 版本；ShapeItemCollection 的 11 项集合能力则没有基类兜底。

4.3 访问器变化

Document.TextBoxes 的 setter 被移除：旧代码若整体替换文本框集合将无法编译，应改为通过 DocumentObjectCollection/TextBoxCollection 的增删方法操作现有集合。

4.4 Obsolete 标记（警告级）

以下 4 个成员新增 [Obsolete]（IsError = false，仅警告）：

• DocumentObjectCollection.Insert(int, IDocumentObject)：建议 Owner.InsertBefore/InsertAfter
• DocumentObjectCollection.RemoveAt(int)：建议 Owner.Remove(documentObject) 或 documentObject.Remove()
• ParagraphCollection.Insert(int, IParagraph)：同上
• TableCollection.Insert(int, ITable)：同上

这体现了新版本的 API 方向：集合自身的增删逐步让位于 CompositeDocumentObject 的 DOM 树操作。

4.5 行为语义变化

• SDT Row/Cell 不再是表格结构：依赖 TableRow/TableCell 的遍历、样式、合并、拆分、XHTML 插入逻辑需要重新设计。
• Comment/Footnote 成为 InlineBody：Body 返回 IBody，可直接 AddParagraph/AddTable；Comment.Items 改为 CommentedItems；Footnote.TextBody 移除，Footnote 自身就是正文。
• TOC 成为 Field：TableOfContent 基类改为 Field，可能影响域更新与类型判断。
• 形状/公式成为复合对象：ShapeBase、OfficeMath 现在有子节点、正文与修订能力；DocPicture/TextBox/ShapeObject 等实现 IBody。
• 集合的基类与返回类型变化：DocumentObjectCollection.Add 不再返回索引；集合层级更统一，但依赖具体基类/返回值的代码会受影响。
• TextBoxCollection 索引器返回 ShapeObject：取出的对象可能是 TextBox 以外的形状，旧代码直接赋给 TextBox 会失败。

5. 兼容性影响分析

5.1 二进制兼容性

结论：即使配置了 bindingRedirect 让程序集加载成功，上述签名/继承变化仍会在首次调用时抛异常；而枚举问题甚至不会抛异常，危害更大。

5.2 源码兼容性

• 编译期错误：类型/成员删除、返回类型变化、参数类型变化、Add 返回值使用、基类变化导致的成员不可见、setter 移除。
• 编译期警告：4 个新增 [Obsolete]。
• 源码兼容但需注意：参数名变化只在命名实参时出错；新增接口成员不会影响调用方；新增 setter 是兼容的。
• 需要显式转换：IParagraphBase/IBody/ShapeObject 返回值、ISectionCollection 索引器、TextBoxCollection 索引器。

5.3 行为兼容性

即使源码全部改到可编译，以下行为仍需回归测试：

1. SDT 行/单元格的表格布局、宽度、合并、拆分、XHTML 插入。
2. 权限范围（start/end/permission）的匹配与编辑器身份。
3. 批注/脚注的正文结构、CommentedItems 与旧 Items 的差异。
4. 目录（TOC）作为 Field 的更新行为。
5. 形状/文本框/图片作为 IBody 后的子内容与文本提取。
6. 集合 Add 后索引、顺序、事件/缓存行为。
7. 页眉页脚集合的枚举与 Count。
8. 文档遍历中 DocumentObjectType 的判断分支。

5.4 兼容性矩阵

6. 迁移指南

6.1 迁移顺序（建议）

6.2 关键代码迁移

（1）枚举判断

// 重新编译后使用常量名，不要使用数字
if (obj.DocumentObjectType == DocumentObjectType.Paragraph) { ... }

// 如果需要把旧持久化数值迁移到新枚举，先按旧常量名映射：
// 旧 4 (Paragraph) -> 新 Paragraph (5)
// 旧 0 (Document)  -> 新 Document (1)
// 旧 63 (Any)      -> 新版本无对应成员

（2）ChildObjects / 子节点

// 旧写法：任意 DocumentObject 都可访问
DocumentObjectCollection children = documentObject.ChildObjects;

// 新写法：仅复合对象有 ChildObjects
if (documentObject is CompositeDocumentObject composite)
{
    DocumentObjectCollection children = composite.ChildObjects;
    DocumentObject first = composite.FirstChild;
    int index = composite.GetIndex(child);
}

（3）集合添加

// Add 不再返回索引
body.ChildObjects.Add(paragraph);
int index = body.ChildObjects.IndexOf(paragraph);

// 强类型集合重载已移除，使用 DocumentObject 重载
row.Cells.Add((DocumentObject)cell);
table.Rows.Insert(0, (DocumentObject)row);

（4）返回接口类型

// 旧写法
ParagraphBase item = doc.CreateParagraphItem(ParagraphItemType.TextRange);
Body body = comment.Body;

// 新写法
IParagraphBase item = doc.CreateParagraphItem(ParagraphItemType.TextRange);
IBody body = comment.Body;

// 需要具体类型时显式转换
var paragraph = (Paragraph)item;

（5）Comment / Footnote

// Comment.Items 已移除
foreach (IParagraphBase item in comment.CommentedItems) { ... }

// Footnote.TextBody 已移除；Footnote 自身就是 IBody
footnote.AddParagraph();
IBody footnoteBody = footnote.Body;

（6）TextBodyPart / TextBodySelection

part.Copy((IParagraphBase)paragraphBase, true);
part.PasteAfter((IParagraphBase)paragraphBase);
var selection = new TextBodySelection((IParagraphBase)start, (IParagraphBase)end);

（7）形状格式

// 旧写法：形状上直接 ApplyCharacterFormat
shape.ApplyCharacterFormat(format);

// 新写法：形状不再继承 ParagraphBase，改用 CharacterFormat 属性/ApplyStyle
shape.ApplyStyle("MyStyle");
// 或逐项复制到 shape.CharacterFormat

（8）IDocCloneable / ISectionCollection

// 命名空间迁移
using Spire.Doc.Interface; // 原 Spire.Doc.CompoundFile
IDocCloneable cloneable = obj;

// IWSectionCollection -> ISectionCollection（空标记接口）
ISectionCollection sections = document.Sections;
Section first = (Section)sections; // 索引器返回 IDocumentObject

（9）TextBoxCollection 索引器

// 旧写法
TextBox textBox = document.TextBoxes;

// 新写法：索引器返回 ShapeObject
TextBox textBox = (TextBox)document.TextBoxes;

6.3 无法自动迁移/需人工设计的事项

1. 持久化的 DocumentObjectType 数值：必须按语义映射，不能按数值沿用。
2. SDT Row/Cell 的表格能力：新模型不再提供 CellFormat、RowFormat、Cells、合并/拆分等；需要重新设计或寻找替代 API。
3. Style.NameToBuiltIn：没有等价替换；需要维护名称映射表（内置样式名与枚举名并不总是一致）。
4. ApplyCharacterFormat：形状/批注/脚注等类型上无等价方法；逐项复制 CharacterFormat 可能无法完全复现原行为。
5. ToString(string separator)：无直接替代；需自行遍历子项拼接。
6. ShapeItemCollection：公开类型仍在，但所有集合操作丢失，且没有公开成员返回该类型；若通过反射/内部途径使用，需要改用其他集合。
7. 权限 ID 分配：字符串→整数是数据模型变更，需要设计唯一性与迁移策略。

7. 非破坏性增强（可加以利用）

7.1 DOM 树操作

DocumentObject 新增 GetText()、Remove()、GetAncestor(...)、GetNextInPreOrder(...)、GetPreviousInPreOrder(...)、HasChildNodes；CompositeDocumentObject 新增 AppendChild、PrependChild、InsertBefore、InsertAfter、RemoveChild、RemoveAllChildren、RemoveChildRange、GetChild、GetChildNodes、整型索引器，以及 ChildObjects/FirstChild/LastChild。这组 API 取代了部分集合增删与手工遍历。

7.2 修订跟踪

新增 IRevisionTracking（8 个成员），35 个类型实现：IsInsertRevision、IsDeleteRevision、IsMoveFromRevision、IsMoveToRevision、InsertRevision、DeleteRevision、MoveFromRevision、MoveToRevision。批注、脚注、段落、域、形状、水印等均可统一处理修订。

7.3 类型化范围集合

• CommentRangeCollection：Comment.CommentedItems，支持 Count、索引器、Contains、IndexOf、ToArray、枚举。
• TextRangeCollection：Paragraph.TextNodes、StructureDocumentTagInline.TextNodes，支持索引器、ToArray、枚举。

7.4 集合与查询增强

• 多个集合新增 ToArray()：ParagraphCollection、TableCollection、CellCollection、RowCollection、FieldCollection、FormFieldCollection、TextBoxCollection、SectionCollection、ParagraphItemCollection、DocumentObjectCollection。
• BookmarkCollection：Count、GetEnumerator、Remove(string)、ResetBookmarkCache。
• PermissionCollection：Count、GetEnumerator、Remove(int)、FindById(int)。
• HeadersFooters.GetHeaderFooterByType(HeaderFooterType)。
• TableRow.FirstCell/LastCell。
• StyleCollection.GetNextAvailableIstd()。
• DocumentNavigator：MoveToBodyStart/End、MoveToBookmark（含重载）、InsertDropDown。

7.5 可写属性与便捷成员

• Bookmark.Name 可写；新增 Bookmark.Text、Bookmark.Remove()、BookmarkStart.Bookmark。
• Field.Separator 可写。
• ShapeBase.Size 可写；Shape.Title 新增；DocPicture.Size 可写。
• Permission.Editor、Permission.Remove()、PermissionStart.Permission、PermissionEnd.PermissionStart。
• Break.Text、Symbol.Text。
• DocumentObjectCollection 的 DocumentObject 强类型重载与 Count。

8. 完整变更清单与工具产物

CSV 列：change, priority, type, member_kind, member_name, category, action, old_signature, new_signature, details。 change 取值：type_added、type_removed、type_modified、member_added、member_removed、member_modified。 priority 口径：P0 必须修改（使用该 API 即编译失败、运行失败或静默错误，169 项）、P1 建议修改（可编译，但存在过时警告、命名实参、继承替代或语义风险，64 项）、P2 仅重编译（新增 API 或纯元数据变化，319 项）。action 给出每行的处置建议。

9. 方法论与验证

9.1 导出方法

1. 使用 Assembly.ReflectionOnlyLoadFrom 仅反射加载目标 DLL，不执行其业务代码。
2. 在 GetTypes() 前遍历 GetReferencedAssemblies() 预加载依赖；对本地存在的依赖使用 ReflectionOnlyLoadFrom 兜底。
3. 使用 BindingFlags.Public | DeclaredOnly 只导出类型自身声明的公开成员；构造函数只取公开构造函数。
4. 对嵌套类型要求整条 DeclaringType 链都公开，避免把内部类型中的 public 嵌套类型误算为导出类型（修正后为 508）。
5. 生成 ECMA-334 XML 文档 ID（T:/M:/P:/F:/E:），与官方 XML 文档交叉校验。
6. 计算“有效成员面”：沿程序集内基类链合并成员；构造函数不继承；仅当新版本中该类型自身或祖先仍提供同名同签名成员时，才算“仍可访问”。

9.2 验证

• 枚举数值：Spire.Doc 启用了防反汇编，ildasm 报“受保护的模块”。改用正常加载 + Enum.GetValues 独立读取，结果与反射导出一致；同时确认 DocumentObjectType 旧 64 项、新 62 项。
• 类型数：首次导出为 538，定位为“内部类型中的 public 嵌套类型”被误计；修正可见性链后为 508，与预期一致。
• 成员键：typeFullName|kind|name(paramTypeKeys)，泛型参数归一化为 !0/!!0，避免把“重载删除+新增”误判为签名修改。
• docId 匹配：旧 4247/5460（77.8%），新 4297/5527（77.7%）；未匹配项多为未写 XML 文档的公开成员。

9.3 局限

• 只比较公开 API；protected/internal 成员、方法体行为、性能与序列化格式不在范围内。
• 未做运行时功能测试；行为结论基于签名、继承关系与类型语义推断。
• 混淆产生的非公开接口（spr...）会出现在 GetInterfaces() 结果中，报告已过滤；导出 JSON 中可能仍包含，分析时需过滤。
• “移动”只按继承关系判定；不尝试跨无关类型猜测重命名/迁移，避免误报。
• 未分析自定义特性（除 Obsolete/Flags/EditorBrowsable）与事件成员之外的高级元数据。

附录 A：新增类型（8）

A.1 新增类型的公开成员

说明：CommentRangeCollection、TextRangeCollection 是新的类型化集合；InlineBody 是 Comment/Footnote 的新基类；IRevisionTracking 是修订跟踪接口；IDocCloneable 从 CompoundFile 命名空间迁移；ISectionCollection 是空标记接口；两个 StructureDocumentTagMark* 是 SDT 边界标记。

附录 B：移除类型（9）

说明：DocumentSubsetCollection 是旧 ParagraphCollection/TableCollection 的基类；SDTContent/SDTInlineContent 是 SDT 内容包装；CompoundFile.IDocCloneable 迁移到 Interface；IWSectionCollection 被 ISectionCollection 替代；ITextBoxItemCollection 无公开实现者；两个嵌套类型是旧集合变更通知的公开产物。

附录 C：新增成员（178）

C.1 新增类型上的成员（37）

这 37 个成员全部位于本版本新增的 8 个类型上，完整清单见附录 A.1，此处不再重复列出。

C.2 既有类型上的新增成员（141）

附录 D：直接声明移除（54 项）

这些成员在旧类型上自身声明，且新版本中该类型及其祖先均不再提供。因基类变化而丢失的继承成员不在此表，见有效成员面统计。

附录 E：仍可通过继承访问的移除项（29 项）

这些成员在旧版本中声明于某类型，新版本中该类型或其祖先仍提供同名同签名成员，通常只需重新编译；其中 DocPicture.Rotation 与 HeadersFooters.GetEnumerator 的签名发生变化，不能按“完全兼容”处理。

附录 F：非枚举修改（37 项）

附录 G：基类变化（19 项）

附录 H：类型元数据接口变化摘要

114 个类型的元数据发生变化。公开接口层面的主要增减：

其中 Spire.Doc.Interface.IDocCloneable 被 114 个类型新增实现；IRevisionTracking 被 35 个类型新增实现；IBody 新增 7 个实现（StructureDocumentTag、Comment、Footnote、DocOleObject、DocPicture、ShapeObject、TextBox），StructureDocumentTagCell 丢失 IBody；ITextRange 新增 3 个实现（Break、Symbol、TableOfContent），IField 新增 1 个实现（TableOfContent）。

非公开/混淆接口（spr...）未计入本表；完整原始接口列表见 JSON 产物。

附录 I：逐类型有效成员面丢失（Top 20）