使用部分

有时您希望文档的所有页面都具有不同的格式。例如，您可能需要修改页码格式、具有不同的页面大小和方向，或者将文档首页作为封面而不进行任何编号。您可以通过部分来实现这一点。

节是控制页眉和页脚、方向、列、边距、页码格式等的级别节点。

Aspose.Words 允许您管理部分、将文档划分为多个部分以及进行仅适用于特定部分的格式更改。 Aspose.Words 存储有关节格式的信息，例如页眉和页脚、页面设置以及分节符中的列设置。

本文介绍如何使用节和分节符。

什么是节和分节符

文档部分由 Section 和 SectionCollection 类表示。节对象是 Document 节点的直接子级，可以通过 Sections 属性进行访问。您可以使用 Remove、Add、IndexOf 等一些方法来管理这些节点。

分节符是一个选项，可将文档页面分为具有可自定义布局的部分。

分节符的类型

Aspose.Words 允许您使用 BreakType 枚举的不同分节符来分割和格式化文档：

• 连续分节符
• 分节符新列
• 分节符新页
• 节盈平衡页
• 分节符奇数页

您还可以使用 SectionStart 枚举来选择仅适用于第一部分的分隔类型，例如 NewColumn、NewPage、EvenPage 和 OddPage。

管理部分

由于节是一个普通的复合节点，因此可以使用全节点操作 API 来操作节：对节进行添加、删除等操作。您可以在 Aspose.Words Document Object Model (DOM) 文章中阅读有关节点的更多信息。

另一方面，您还可以使用 DocumentBuilder API 来处理部分。在本文中，我们将重点讨论这种使用节的特殊方式。

插入或删除分节符

Aspose.Words 允许您使用 InsertBreak 方法在文本中插入分节符。

以下代码示例演示如何在文档中插入分节符：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
/// <summary>
/// Insert section breaks before the specified paragraphs.
/// </summary>
private void InsertSectionBreaks(List<Paragraph> topicStartParas)
{
    DocumentBuilder builder = new DocumentBuilder(mDoc);
    foreach (Paragraph para in topicStartParas)
    {
        Section section = para.ParentSection;

        // Insert section break if the paragraph is not at the beginning of a section already.
        if (para != section.Body.FirstParagraph)
        {
            builder.MoveTo(para.FirstChild);
            builder.InsertBreak(BreakType.SectionBreakNewPage);

            // This is the paragraph that was inserted at the end of the now old section.
            // We don't really need the extra paragraph, we just needed the section.
            section.Body.LastParagraph.Remove();
        }
    }
}

使用 Remove 方法删除分节符。如果您不需要删除特定分节符而是删除该节的内容，则可以使用 ClearContent 方法。

以下代码示例展示了如何删除分节符：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
private void RemoveSectionBreaks(Document doc)
{
    // Loop through all sections starting from the section that precedes the last one and moving to the first section.
    for (int i = doc.Sections.Count - 2; i >= 0; i--)
    {
        // Copy the content of the current section to the beginning of the last section.
        doc.LastSection.PrependContent(doc.Sections[i]);
        // Remove the copied section.
        doc.Sections[i].Remove();
    }
}

请注意，分节符包含有关其之前的部分的信息，而不是有关其之后的部分的信息。因此，如果删除分节符，则删除的分节符之前的文本将获得其后面的分节符的属性。这可能会导致整个文档变成横向，或者页眉和页脚发生变化或完全消失。

移动一个部分

如果要将文档中的某个部分从一个位置移动到另一个位置，则需要获取该部分的索引。 Aspose.Words 允许您使用 Item 属性从 SectionCollection 中获取章节位置。您可以使用 Sections 属性获取文档中的所有部分。但如果您只想获取第一部分，则可以使用 FirstSection 属性。

以下代码示例演示如何访问第一部分并迭代复合节点的子节点：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Section 1");
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.Write("Primary header");
builder.MoveToHeaderFooter(HeaderFooterType.FooterPrimary);
builder.Write("Primary footer");

Section section = doc.FirstSection;

// A Section is a composite node and can contain child nodes,
// but only if those child nodes are of a "Body" or "HeaderFooter" node type.
foreach (Node node in section)
{
    switch (node.NodeType)
    {
        case NodeType.Body:
            {
                Body body = (Body)node;

                Console.WriteLine("Body:");
                Console.WriteLine($"\t\"{body.GetText().Trim()}\"");
                break;
            }
        case NodeType.HeaderFooter:
            {
                HeaderFooter headerFooter = (HeaderFooter)node;

                Console.WriteLine($"HeaderFooter type: {headerFooter.HeaderFooterType}:");
                Console.WriteLine($"\t\"{headerFooter.GetText().Trim()}\"");
                break;
            }
        default:
            {
                throw new Exception("Unexpected node type in a section.");
            }
    }
}

指定部分布局

有时，您希望通过为文档的不同部分制作创意布局来使文档看起来更好。如果要指定当前截面网格的类型，可以使用 SectionLayoutMode 枚举选择截面布局模式：

• 默认
• 网格
• 线网格
• SnapToChars

以下代码示例显示如何限制每个页面可以拥有的行数：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Enable pitching, and then use it to set the number of lines per page in this section.
// A large enough font size will push some lines down onto the next page to avoid overlapping characters.
builder.PageSetup.LayoutMode = SectionLayoutMode.LineGrid;
builder.PageSetup.LinesPerPage = 15;

builder.ParagraphFormat.SnapToGrid = true;

for (int i = 0; i < 30; i++)
    builder.Write("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ");

doc.Save(ArtifactsDir + "WorkingWithDocumentOptionsAndSettings.LinesPerPage.docx");

编辑部分

当您向文档添加新部分时，将没有可以编辑的正文或段落。 Aspose.Words 允许您使用 EnsureMinimum 方法保证一个节包含至少一个段落的正文 - 它会自动向文档添加一个 Body（或 HeaderFooter）节点，然后向其中添加一个 Paragraph。

以下代码示例展示了如何使用 EnsureMinimum 准备新的节节点：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();

// If we add a new section like this, it will not have a body, or any other child nodes.
doc.Sections.Add(new Section(doc));
// Run the "EnsureMinimum" method to add a body and a paragraph to this section to begin editing it.
doc.LastSection.EnsureMinimum();
            
doc.Sections[0].Body.FirstParagraph.AppendChild(new Run(doc, "Hello world!"));

追加或前置内容

如果您想在部分的开头/结尾绘制某些形状或添加文本或图像，可以使用 Section 类的 AppendContent 和 PrependContent 方法。

以下代码示例演示如何附加现有部分的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Section 1");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Write("Section 2");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Write("Section 3");

Section section = doc.Sections[2];

// Insert the contents of the first section to the beginning of the third section.
Section sectionToPrepend = doc.Sections[0];
section.PrependContent(sectionToPrepend);

// Insert the contents of the second section to the end of the third section.
Section sectionToAppend = doc.Sections[1];
section.AppendContent(sectionToAppend);

克隆一个部分

Aspose.Words 允许您通过使用 Clone 方法创建该部分的完整副本来复制该部分。

以下代码示例演示如何克隆文档中的第一部分：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Document.docx");
Section cloneSection = doc.Sections[0].Clone();

复制文档之间的部分

在某些情况下，您可能拥有包含许多部分的大型文档，并且您希望将某个部分的内容从一个文档复制到另一个文档。

Aspose.Words 允许您使用 ImportNode 方法复制文档之间的部分。

以下代码示例演示如何在文档之间复制部分：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document srcDoc = new Document(MyDir + "Document.docx");
Document dstDoc = new Document();

Section sourceSection = srcDoc.Sections[0];
Section newSection = (Section)dstDoc.ImportNode(sourceSection, true);
dstDoc.Sections.Add(newSection);

dstDoc.Save(ArtifactsDir + "WorkingWithSection.CopySection.docx");

使用节页眉和页脚

显示每个部分的页眉或页脚的基本规则非常简单：

1. 如果该节没有自己的某种类型的页眉/页脚，则它取自上一节。
2. 页面上显示的页眉/页脚类型由"不同首页"和"不同奇数页和偶数页"部分设置控制 - 如果禁用它们，则忽略该部分自己的标题。

以下代码示例演示如何创建具有不同标头的 2 个部分：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.PageSetup.DifferentFirstPageHeaderFooter = true;

builder.MoveToHeaderFooter(HeaderFooterType.HeaderFirst);
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;
builder.Font.Name = "Arial";
builder.Font.Bold = true;
builder.Font.Size = 14;
builder.Write("Header for the first page.");

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

Section currentSection = builder.CurrentSection;
PageSetup pageSetup = currentSection.PageSetup;
pageSetup.Orientation = Orientation.Landscape;
// This section does not need a different first-page header/footer we need only one title page in the document,
// and the header/footer for this page has already been defined in the previous section.
pageSetup.DifferentFirstPageHeaderFooter = false;

// This section displays headers/footers from the previous section
// by default call currentSection.HeadersFooters.LinkToPrevious(false) to cancel this page width
// is different for the new section.
currentSection.HeadersFooters.LinkToPrevious(false);
currentSection.HeadersFooters.Clear();

builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;
builder.Font.Name = "Arial";
builder.Font.Size = 12;
builder.Write("New Header for the first page.");

doc.Save(ArtifactsDir + "WorkingWithHeadersAndFooters.LinkToPreviousHeaderFooter.docx");

如果要删除页眉和页脚的文本而不删除文档中的 HeaderFooter 对象，可以使用 ClearHeadersFooters 方法。此外，您可以使用 DeleteHeaderFooterShapes 方法从文档的页眉和页脚中删除所有形状。

以下代码示例演示如何清除节中所有页眉和页脚的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Document.docx");

Section section = doc.Sections[0];
section.ClearHeadersFooters();

以下代码示例如何从节中的所有页眉页脚中删除所有形状：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Document.docx");

Section section = doc.Sections[0];
section.DeleteHeaderFooterShapes();

自定义部分中的页面属性

在打印页面或文档之前，您可能需要自定义和修改单页或整个文档的尺寸和布局。通过页面设置，您可以更改文档页面的设置，例如页边距、方向和尺寸，以打印不同的首页或奇数页。

Aspose.Words 允许您使用 PageSetup 类自定义页面和部分属性。

以下代码示例显示如何设置当前部分的页面大小和方向等属性：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.LeftMargin = 50;
builder.PageSetup.PaperSize = PaperSize.Paper10x14;

doc.Save(ArtifactsDir + "WorkingWithDocumentOptionsAndSettings.PageSetupAndSectionFormatting.docx");

以下代码示例展示了如何修改所有部分中的页面属性：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Section 1");
doc.AppendChild(new Section(doc));
builder.Writeln("Section 2");
doc.AppendChild(new Section(doc));
builder.Writeln("Section 3");
doc.AppendChild(new Section(doc));
builder.Writeln("Section 4");

// It is important to understand that a document can contain many sections,
// and each section has its page setup. In this case, we want to modify them all.
foreach (Section section in doc)
    section.PageSetup.PaperSize = PaperSize.Letter;

doc.Save(ArtifactsDir + "WorkingWithSection.ModifyPageSetupInAllSections.doc");

也可以看看

• 文档中节点的逻辑级别
• 插入和附加文档