How to Insert Page Breaks Before Heading in Word using C# .NET Core?

Syncfusion® Essential® DocIO is a .NET Word library used to create, read, edit, and convert Word documents programmatically without Microsoft Word or interop dependencies. Using this library, you can insert page breaks before specific heading paragraphs in a Word document using C#.

Overview of the Insert Page Breaks Before Heading Paragraphs Logic:

• Open the Word document.
• Retrieve all paragraphs styled as Heading 1.
• If the heading paragraph is not the first in the text body and no page break exists before it, insert a new page break. Otherwise, skip inserting a page break.
• Save the document.

Steps to insert page breaks before specific heading paragraphs in a Word document:

1. Create a new .NET Core console application project.
   
   
2. Install the Syncfusion.DocIO.Net.Core NuGet package as a reference to your project from NuGet.org.
   
   

3. Include the following namespaces in the Program.cs file.
   C#

using Syncfusion.DocIO.DLS;
using Syncfusion.DocIO;

4. Use the following code example to insert page breaks before specific heading paragraphs in a Word document.
   C#

// Load the existing Word document
WordDocument document = new WordDocument(Path.GetFullPath("Data/Input.docx"));
// Find all paragraphs with the style "Heading 1"
List<Entity> entities = document.FindAllItemsByProperty(EntityType.Paragraph, "StyleName", "Heading 1");

if (entities == null)
{
    Console.WriteLine("No paragraphs with the style 'Heading 1' found.");                
}
else
{
    foreach (Entity entity in entities)
    {        
        WParagraph paragraph = entity as WParagraph;
        // Get the index of the current paragraph in its parent text body
        int index = paragraph.OwnerTextBody.ChildEntities.IndexOf(paragraph);
        // Continue only if there is a previous entity
        if (index > 0)
        {
            // Get the previous entity and cast it to a paragraph
            WParagraph previousParagraph = paragraph.OwnerTextBody.ChildEntities[index - 1] as WParagraph;
            bool hasPageBreak = false;
            // Check if the previous paragraph ends with a page break
            if (previousParagraph != null && previousParagraph.ChildEntities.Count > 0)
            {
                // Get the last item in the previous paragraph
                ParagraphItem lastItem = previousParagraph.ChildEntities[previousParagraph.ChildEntities.Count - 1] as ParagraphItem;
                // Enable the boolean if the last item is a page break
                if (lastItem is Break && (lastItem as Break).BreakType == BreakType.PageBreak)
                    hasPageBreak = true;
            }
            // If no page break is found, insert the page break before the current paragraph
            if (!hasPageBreak)
            {
                WParagraph newPara = new WParagraph(document);
                newPara.AppendBreak(BreakType.PageBreak);
                // Insert the new paragraph with page break at the correct position
                paragraph.OwnerTextBody.ChildEntities.Insert(index, newPara);
            }
        }
    }
}
 // Save the Word document.   
document.Save(Path.GetFullPath("../../../Output/Output.docx"));
// Close the Word document.
document.Close();

You can download a complete working sample to insert page breaks before specific heading paragraphs in a Word document from GitHub.

Final Output Image:

Take a moment to peruse the documentation where you can find basic Word document processing options along with features like mail merge, merge, split, and compare Word documents, find and replace text in the Word document, protect the Word documents, and most importantly, the PDF and Image conversions with code examples.

Conclusion

I hope you enjoyed learning about how to insert page breaks before specific heading paragraphs in a Word document in a .NET Core Word document.

You can refer to our ASP.NET Core DocIO feature tour page to know about its other groundbreaking feature representations and documentation, and how to quickly get started with configuration specifications. You can also explore our ASP.NET Core DocIO example to understand how to create and manipulate data.

For current customers, you can check out our components from the License and Downloads page. If you are new to Syncfusion®, you can try our 30-day free trial to check out our other controls.

If you have any queries or require clarifications, please let us know in the comments section below. You can also contact us through our support forums, Direct-Trac, or feedback portal. We are always happy to assist you!