如何在C#的StringBuilder中添加回车换行？DOCX发票地址换行异常求助

我来帮你搞定这个问题！你遇到的核心卡点是：普通文本换行符在OOXML表格单元格里不会自动渲染成换行效果，得结合StringBuilder的正确换行方式，再配合OOXML SDK的文档结构来处理才行。

一、先搞懂StringBuilder里怎么加回车/换行 #

在C#的StringBuilder里添加换行有两种常用方式，都很简单：

• 用AppendLine()方法：它会自动追加当前系统的换行符（Windows环境下是\r\n），比如：

  var sb = new StringBuilder();
  sb.AppendLine("北京市朝阳区XX路");
  sb.AppendLine("XX大厦15层");
  sb.AppendLine("XX室");
  

• 手动添加换行符：可以用Environment.NewLine（跨平台友好）或者直接写\r\n，比如：

  sb.Append("北京市朝阳区XX路").Append(Environment.NewLine);
  sb.Append("XX大厦15层").Append("\r\n");
  

不过要注意：这只是在字符串层面添加了换行标记，直接把这个字符串塞进OOXML的单元格里，DOCX还是不会显示换行——因为OOXML的文档结构是XML，它不认纯文本的换行符，得用专门的元素来定义换行。

二、OOXML SDK中让地址换行的正确姿势 #

DOCX里的换行需要用段落分隔（<w:p>）或者换行元素（<w:br>），下面给你两种实用的实现方式：

方式1：把每一行地址做成独立段落 #

这种方式适合需要给不同地址行设置不同格式的场景，代码示例：

// 假设从SQL取出的地址列是addr1、addr2、addr3
string addr1 = "北京市朝阳区XX路";
string addr2 = "XX大厦15层";
string addr3 = "XX室";

// 创建表格单元格
TableCell addressCell = new TableCell();

// 遍历地址行，每一行创建一个独立段落
foreach (string addrLine in new[] { addr1, addr2, addr3 })
{
    if (!string.IsNullOrWhiteSpace(addrLine)) // 跳过空行
    {
        // 构建段落：Paragraph -> Run -> Text
        Paragraph para = new Paragraph(
            new Run(
                new Text(addrLine)
            )
        );
        addressCell.Append(para);
    }
}

// 最后把这个单元格添加到表格行里即可
// tableRow.Append(addressCell);

方式2：在同一个段落里添加OOXML换行元素 #

如果希望所有地址行共用同一个段落格式（比如统一的字体、缩进），可以用这种方式，把换行符转换成OOXML的<w:br>元素：

// 先用StringBuilder拼接带换行的地址字符串
var sb = new StringBuilder();
sb.AppendLine(addr1);
sb.AppendLine(addr2);
sb.AppendLine(addr3);

// 把字符串按换行拆分
string[] addrLines = sb.ToString().Split(
    new[] { Environment.NewLine }, 
    StringSplitOptions.RemoveEmptyEntries
);

// 创建一个段落，把每一行地址和换行元素加进去
Paragraph addrPara = new Paragraph();
for (int i = 0; i < addrLines.Length; i++)
{
    // 添加地址文本
    addrPara.Append(new Run(new Text(addrLines[i])));
    // 不是最后一行的话，添加OOXML换行元素
    if (i != addrLines.Length - 1)
    {
        addrPara.Append(new Run(new Break()));
    }
}

// 把段落塞进单元格
TableCell addressCell = new TableCell(addrPara);
// 再把单元格加入表格行
// tableRow.Append(addressCell);

为什么之前的方法无效？ #

因为OOXML的文档模型是基于XML的，纯文本里的\r\n只是字符串的一部分，DOCX渲染引擎不会把它解析成换行。必须显式添加Break元素（对应<w:br>标签）或者拆分出多个Paragraph（对应<w:p>标签），才能让地址在文档里显示成单独的行。

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