使用GemBox Document执行Word邮件合并遇特殊字符异常求助

直接给Run.Text赋值带换行、制表符的文本会触发异常，因为GemBox要求这类特殊格式必须用SpecialCharacter实例实现，不能直接写在文本里。可以按以下方式修改FieldMerging事件的代码，保留特殊字符的同时完成合并：

• 取消默认合并逻辑，避免自动赋值触发错误
• 将带特殊字符的文本拆分成普通文本段和特殊字符两部分
• 逐个将普通文本（用Run）和特殊字符（对应SpecialCharacter类型）添加到合并域所在的段落中

示例代码 #

private void Document_FieldMerging(object sender, FieldMergingEventArgs e)
{
    // 根据实际需求过滤需要处理的自定义域
    if (e.FieldName == "TargetFieldName")
    {
        e.Cancel = true; // 取消默认合并行为，避免自动赋值报错
        var fieldParent = e.Field.Start.Parent;
        var text = e.FieldValue?.ToString() ?? string.Empty;

        int currentIndex = 0;
        for (int i = 0; i < text.Length; i++)
        {
            char c = text[i];
            if (c == '\n' || c == '\t')
            {
                // 插入当前位置前的普通文本段
                if (i > currentIndex)
                {
                    var run = new Run(e.Document, text.Substring(currentIndex, i - currentIndex));
                    fieldParent.InsertChildBefore(e.Field.Start, run);
                }

                // 插入对应类型的特殊字符
                SpecialCharacter specialChar = c == '\n' 
                    ? new SpecialCharacter(e.Document, SpecialCharacterType.LineBreak) 
                    : new SpecialCharacter(e.Document, SpecialCharacterType.Tab);
                fieldParent.InsertChildBefore(e.Field.Start, specialChar);

                currentIndex = i + 1;
            }
        }

        // 插入剩余的普通文本
        if (currentIndex < text.Length)
        {
            var run = new Run(e.Document, text.Substring(currentIndex));
            fieldParent.InsertChildBefore(e.Field.Start, run);
        }

        // 移除原合并域
        e.Field.Remove();
    }
}

代码说明 #

• e.Cancel = true：阻止GemBox自动处理域值，规避特殊字符导致的异常
• 遍历文本拆分处理：遇到\n创建换行特殊字符，遇到\t创建制表符特殊字符，普通文本段用Run实例插入
• 最后移除原合并域，确保文档中只保留处理后的内容

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