Aspose.Words C#：如何在新页面开头添加段落（解决空白页问题）

问题场景 #

我正在使用Aspose.Words的C#评估版，通过报表功能生成动态Word文档的流程正常。但打开生成好的报表文档后，想在新页面开头添加段落时遇到了问题：

• 执行当前代码后，会先出现一个空白页，之后才是带有目标段落的新页面
• 去掉分页符的话，段落前又会多出多余换行

当前代码：

Document finalDoc = new Document(@"C:\Words\reportFinal.docx");

DocumentBuilder builder = new DocumentBuilder(finalDoc);

builder.MoveToDocumentEnd();
builder.InsertBreak(BreakType.PageBreak);
// Specify font formatting
Font font = builder.Font;
font.Size = 16;
font.Bold = true;
font.Name = "Arial";
font.Underline = Underline.Dash;

// Specify paragraph formatting
ParagraphFormat paragraphFormat = builder.ParagraphFormat;
paragraphFormat.FirstLineIndent = 8;
paragraphFormat.Alignment = ParagraphAlignment.Justify;
paragraphFormat.KeepTogether = true;

builder.Writeln("A whole paragraph.");

问题原因 #

MoveToDocumentEnd()会将光标定位到文档最后一个段落的之后，如果文档末尾原本就有一个空段落，插入分页符后，这个空段落会被单独分到一页，导致后续段落只能跳到下一页，从而出现空白页。

解决方法 #

方法1：定位到最后一个段落的末尾 #

直接将光标移到文档最后一个段落的结尾，而非文档整体末尾，这样插入的分页符会紧跟在最后一段内容之后，不会触发空白页：

Document finalDoc = new Document(@"C:\Words\reportFinal.docx");
DocumentBuilder builder = new DocumentBuilder(finalDoc);

// 定位到最后一个段落的末尾
Paragraph lastPara = finalDoc.LastSection.Body.LastParagraph;
builder.MoveTo(lastPara);

builder.InsertBreak(BreakType.PageBreak);

// 字体格式设置
Font font = builder.Font;
font.Size = 16;
font.Bold = true;
font.Name = "Arial";
font.Underline = Underline.Dash;

// 段落格式设置
ParagraphFormat paragraphFormat = builder.ParagraphFormat;
paragraphFormat.FirstLineIndent = 8;
paragraphFormat.Alignment = ParagraphAlignment.Justify;
paragraphFormat.KeepTogether = true;

builder.Writeln("A whole paragraph.");

方法2：移除末尾的空段落 #

如果文档末尾确实存在多余的空段落，可以先删除它，再执行插入操作：

Document finalDoc = new Document(@"C:\Words\reportFinal.docx");
DocumentBuilder builder = new DocumentBuilder(finalDoc);

Section lastSection = finalDoc.LastSection;
Body body = lastSection.Body;

// 检查并删除末尾的空段落
if (body.LastParagraph != null && string.IsNullOrEmpty(body.LastParagraph.GetText().Trim()))
{
    body.LastParagraph.Remove();
}

builder.MoveToDocumentEnd();
builder.InsertBreak(BreakType.PageBreak);

// 后续格式和写入代码不变
Font font = builder.Font;
font.Size = 16;
font.Bold = true;
font.Name = "Arial";
font.Underline = Underline.Dash;

ParagraphFormat paragraphFormat = builder.ParagraphFormat;
paragraphFormat.FirstLineIndent = 8;
paragraphFormat.Alignment = ParagraphAlignment.Justify;
paragraphFormat.KeepTogether = true;

builder.Writeln("A whole paragraph.");

额外提示 #

如果去掉分页符后仍有多余换行，可以尝试用builder.Write()代替builder.Writeln()，避免自动添加额外换行，同时确保段落格式设置正确，让段落正常显示。

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