如何用.NET、C#、OpenXML及OpenXmlPowerTools替换Word文档首次匹配内容

要实现仅替换首次匹配项，核心是利用回调函数的状态捕获能力——通过一个外部变量记录是否已经完成过替换，首次匹配时返回true执行替换，后续所有匹配都返回false跳过。

具体实现代码 #

// 定义变量跟踪是否已完成首次替换
bool hasReplacedFirstMatch = false;

int replacedCount = OpenXmlRegex.Replace(
    content,
    regex,
    replacement,
    (element, match) =>
    {
        if (!hasReplacedFirstMatch)
        {
            hasReplacedFirstMatch = true;
            return true; // 首次匹配，执行替换
        }
        return false; // 后续匹配，跳过替换
    });

原理说明 #

• 变量hasReplacedFirstMatch被lambda回调捕获，初始值为false。
• 第一次进入回调时，变量为false，将其设为true并返回true，触发替换操作。
• 后续所有匹配进入回调时，变量已为true，直接返回false，跳过替换。

注意事项 #

• 确保hasReplacedFirstMatch变量的作用域仅覆盖当前替换操作，避免多次替换时状态混乱。
• 单线程处理Word文档时无需额外同步，多线程场景需添加lock等线程安全机制。

内容的提问来源于stack exchange，提问作者Manuel Rivera