Open-XML-SDK 中处理Word文档修订标记的技术解析

在处理Word文档时，修订跟踪功能生成的标记是开发中常见的挑战。本文将深入探讨如何使用Open-XML-SDK正确处理Word文档中的各种修订标记，特别是移动内容(MoveFrom/MoveTo)这类复杂标记。

修订标记处理概述

Word文档中的修订标记主要包括插入内容(InsertedRun)、删除内容(DeletedRun)以及移动内容(MoveFrom/MoveTo)等类型。这些标记在Open-XML-SDK中都有对应的类表示，开发者需要理解它们的结构才能正确处理。

基础修订标记处理

对于简单的插入和删除标记，处理相对直接：

1. 插入内容处理：需要将InsertedRun标记中的内容提取出来，保留实际文本而移除标记本身
2. 删除内容处理：直接移除DeletedRun标记及其包含的内容

移动内容标记的复杂性

移动内容标记(MoveFrom/MoveTo)的处理最为复杂，它表示内容从一个位置移动到另一个位置。这类标记通常成对出现：

• MoveFrom标记在原位置
• MoveTo标记在新位置

处理这类标记时，需要特别注意保持文档结构的完整性，同时确保移动的内容被正确保留在新位置。

完整处理方案

以下是处理各类修订标记的推荐方法：

1. 处理插入内容：

var insertedRuns = body.Descendants<InsertedRun>().ToList();
foreach (var insertedRun in insertedRuns) {
    var parent = insertedRun.Parent;
    foreach (var child in insertedRun.ChildElements.ToList()) {
        parent.InsertBefore(child.CloneNode(true), insertedRun);
    }
    insertedRun.Remove();
}

2. 处理删除内容：

var deletedRuns = body.Descendants<DeletedRun>().ToList();
foreach (var deletedRun in deletedRuns) {
    deletedRun.Remove();
}

3. 处理移动内容：

// 处理MoveFrom相关标记
var moveFromElements = body.Descendants<MoveFromRun>().Cast<OpenXmlElement>().ToList();
moveFromElements.AddRange(body.Descendants<ParagraphMarkRunProperties>()
    .Where(p => p.Descendants<MoveFrom>() != null).ToList());
// 其他MoveFrom相关元素...

foreach (var fromElement in moveFromElements) {
    fromElement.Remove();
}

// 处理MoveTo相关标记
var moveToElements = body.Descendants<MoveToRun>().Cast<OpenXmlElement>().ToList();
// 其他MoveTo相关元素...

foreach (var toElements in moveToElements) {
    foreach (var run in toElements.Elements<Run>()) {
        if (run == toElements.FirstChild) {
            toElements.InsertAfterSelf(new Run(run.OuterXml));
        } else {
            var nextSibling = toElements.NextSibling();
            nextSibling.InsertAfterSelf(new Run(run.OuterXml));
        }
    }
    toElements.Remove();
}

技术要点

1. 克隆节点：在处理插入内容时，使用CloneNode(true)确保深度复制所有子节点
2. 元素定位：通过Parent和NextSibling等方法精确定位元素位置
3. 批量处理：先将所有需要处理的元素收集到列表中，再统一处理，避免修改过程中影响遍历
4. 完整性检查：处理完成后应验证文档结构是否完整

最佳实践建议

1. 在处理前备份原始文档
2. 分阶段处理不同类型的修订标记
3. 处理完成后进行文档验证
4. 考虑性能优化，特别是处理大型文档时

通过理解Word文档修订标记的结构和掌握Open-XML-SDK提供的处理方法，开发者可以有效地实现文档修订的接受功能，满足各种文档处理需求。