Summary
When a heading is inside a table that breaks across two pages, the page number stored in the generated Table of Contents (TOC) can become incorrect after UpdateFields is called. The heading is re‑flowed to the second page, but the TOC still points to the original page because the document layout was not refreshed before the field update.
Why it happens
- The TOC field (
{ TOC \h }) reads page numbers from the layout that exists before the field is updated. - A table row that is allowed to split across pages (
Row.IsBreakAcrossPagesAllowed = true) may be moved to the next page after the initial layout pass. Document.UpdateFields()does not trigger a new layout pass, so the TOC retains the stale page numbers.- Preventing the row from breaking or forcing a layout pass before updating the fields resolves the mismatch.
What to do next
- Force a layout pass before updating the TOC
// Load the document
var doc = new Aspose.Words.Document("input.docx");
// Re‑calculate layout with the current content
doc.UpdatePageLayout(); // important
// Update all fields, including the TOC
doc.UpdateFields();
// Save the result
doc.Save("output.docx");
- Keep the heading row on a single page (recommended when the heading resides in a table)
// Locate heading paragraphs
foreach (Paragraph para in doc.GetChildNodes(NodeType.Paragraph, true))
{
if (para.ParagraphFormat.StyleIdentifier == StyleIdentifier.Heading1)
{
// Get the containing table row, if any
Row headingRow = (Row)para.GetAncestor(NodeType.Row);
if (headingRow != null)
{
// Prevent the row from breaking across pages
headingRow.IsBreakAcrossPagesAllowed = false;
// Optionally keep the heading with the following paragraph
para.ParagraphFormat.KeepWithNext = true;
}
}
}
// Re‑layout and update fields again
doc.UpdatePageLayout();
doc.UpdateFields();
doc.Save("output_fixed.docx");
-
Alternative: move the heading out of the table
If you can modify the source document, place the heading paragraph outside the table. This eliminates the cross‑page‑table side‑effect entirely. -
Verify the result
- Open the saved file and confirm that the TOC entry now points to the correct page.
- If the page numbers are still off, repeat the layout‑update step after any further content changes.
If the issue persists after applying these steps, please provide a minimal reproducible document so the layout behavior can be examined further.
I could not fully verify this explanation against the retrieved sources. Please double-check the behaviour in your environment and confirm the exact SDK/version.
// 1. 加载模板文件
InputStream templateStream = new ClassPathResource("/word_tpl/monthly-meeting-materials-tpl.docx").getInputStream();
Document templateDoc = new Document(templateStream);
// 2. 加载上传的正文文件
Document contentDoc = new Document(file.getInputStream());
// 3. 替换模板中的占位符
replacePlaceholders(templateDoc, month);
// 4. 将正文内容追加到模板
templateDoc.appendDocument(contentDoc, ImportFormatMode.KEEP_SOURCE_FORMATTING);
// 5. 更新目录字段
templateDoc.updatePageLayout();
templateDoc.updateFields();
for (Field field : templateDoc.getRange().getFields()) {
if (field.getType() == FieldType.FIELD_TOC)
{
FieldToc toc = (FieldToc)field;
toc.updatePageNumbers();
toc.update();
}
}
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions();
saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL);
// 6. 保存Aspose处理后的临时文件
tempAsposeFile = System.getProperty("java.io.tmpdir") + "/aspose_temp_" + UUID.randomUUID() + ".docx";
templateDoc.save(tempAsposeFile); 这是我的代码，文件是生成后的文档
12月月度例会会议材料99999000.docx (712.5 KB)
