Xceed Docx ReplaceText报错newValue cannot be null，求解决方法

看起来你遇到的问题是Xceed DocX的ReplaceText方法对空字符串的处理比较严格——即使你传的是空字符串""，它内部可能会把这个当作null来处理，从而抛出那个错误。结合你的代码和常见的坑，给你几个可行的解决方案：

方案1：用空白字符替代空字符串，再按需移除 #

如果你的需求是完全清除占位符的内容，不要直接传""，可以先传一个空白字符，再找到对应的文本元素移除：

if (sur.RequestType) { 
    templateDoc.ReplaceText("[#1]", "x"); 
    // 先替换成空白字符避免错误
    templateDoc.ReplaceText("[#2]", " "); 
    // 找到所有匹配的元素并移除，彻底清除占位符
    var targetElements = templateDoc.FindAll("[#2]");
    foreach (var elem in targetElements)
    {
        elem.Remove();
    }
} else { 
    templateDoc.ReplaceText("[#1]", " "); 
    templateDoc.ReplaceText("[#2]", "x"); 
    var targetElements = templateDoc.FindAll("[#1]");
    foreach (var elem in targetElements)
    {
        elem.Remove();
    }
}

方案2：检查并使用支持空值的重载方法 #

有些版本的Xceed DocX为ReplaceText提供了重载，允许传入一个布尔参数来允许空值替换。如果你的组件版本支持，可以试试：

// 第三个参数设为true，允许空字符串作为替换值
templateDoc.ReplaceText("[#2]", "", true);

不过要注意，这个重载不是所有版本都有，你可以查看当前使用的DocX库的API文档确认。

方案3：先验证占位符存在性再替换 #

有时候如果模板里没有对应的占位符，ReplaceText也可能抛出奇怪的异常。可以先检查占位符是否存在，再执行替换：

var hasPlaceholder1 = templateDoc.FindAll("[#1]").Any();
var hasPlaceholder2 = templateDoc.FindAll("[#2]").Any();

if (sur.RequestType) { 
    if (hasPlaceholder1) templateDoc.ReplaceText("[#1]", "x"); 
    if (hasPlaceholder2) templateDoc.ReplaceText("[#2]", " "); 
} else { 
    if (hasPlaceholder1) templateDoc.ReplaceText("[#1]", " "); 
    if (hasPlaceholder2) templateDoc.ReplaceText("[#2]", "x"); 
}

调试小技巧 #

• 调试时可以暂停在ReplaceText调用前，检查传入的newValue是否真的是空字符串，有没有其他逻辑意外把它设为null；
• 打开你的模板文档，仔细检查占位符[#1]和[#2]的格式，有没有多余的空格、大小写不一致的情况——这些都可能导致替换失败或者触发异常。

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