Section

Section class

代表文档中的单个部分。

要了解更多信息，请访问使用部分文档文章。

public sealed class Section : CompositeNode

构造函数

姓名描述
Section(DocumentBase)初始化 Section 类的新实例。

特性

姓名描述
Body { get; }返回Body该部分的子节点。
Count { get; }获取此节点的直属子节点的数量。
CustomNodeId { get; set; }指定自定义节点标识符。
virtual Document { get; }获取此节点所属的文档。
FirstChild { get; }获取节点的第一个子节点。
HasChildNodes { get; }返回真的如果此节点有任何子节点。
HeadersFooters { get; }提供对该部分的页眉和页脚节点的访问。
override IsComposite { get; }返回真的因为这个节点可以有子节点。
LastChild { get; }获取节点的最后一个子节点。
NextSibling { get; }获取紧随此节点之后的节点。
override NodeType { get; }返回Section.
PageSetup { get; }返回代表页面设置和部分属性的对象。
ParentNode { get; }获取此节点的直接父节点。
PreviousSibling { get; }获取此节点前一个节点。
ProtectedForForms { get; set; }如果该部分受表单保护，则为 True。当某个部分受表单保护时， 用户只能在 Microsoft Word 中选择和修改表单域中的文本。
Range { get; }返回Range表示此节点中包含的文档部分的对象。

方法

姓名描述
override Accept(DocumentVisitor)接受访客。
override AcceptEnd(DocumentVisitor)
override AcceptStart(DocumentVisitor)
AppendChild<T>(T)将指定节点添加到此节点的子节点列表的末尾。
AppendContent(Section)在本节末尾插入源节内容的副本。
ClearContent()清除该部分。
ClearHeadersFooters()清除此部分的页眉和页脚。
ClearHeadersFooters(bool)清除此部分的页眉和页脚。
Clone()创建此部分的副本。
Clone(bool)创建节点的副本。
CreateNavigator()创建可用于遍历和读取节点的导航器。
DeleteHeaderFooterShapes()从本节的页眉和页脚中删除所有形状（绘图对象）。
EnsureMinimum()确保该部分具有Body有一个Paragraph.
GetAncestor(NodeType)获取指定的第一个祖先NodeType.
GetAncestor(Type)获取指定对象类型的第一个祖先。
GetChild(NodeType, int, bool)返回与指定类型匹配的第 N 个子节点。
GetChildNodes(NodeType, bool)返回与指定类型匹配的子节点的实时集合。
GetEnumerator()为该节点的子节点提供对每个样式迭代的支持。
override GetText()获取此节点及其所有子节点的文本。
IndexOf(Node)返回子节点数组中指定子节点的索引。
InsertAfter<T>(T, Node)在指定的参考节点后立即插入指定的节点。
InsertBefore<T>(T, Node)在指定的参考节点之前立即插入指定的节点。
NextPreOrder(Node)根据前序树遍历算法获取下一个节点。
PrependChild<T>(T)将指定节点添加到此节点的子节点列表的开头。
PrependContent(Section)在本节开头插入源节内容的副本。
PreviousPreOrder(Node)根据前序树遍历算法获取前一个节点。
Remove()将自身从父级中移除。
RemoveAllChildren()删除当前节点的所有子节点。
RemoveChild<T>(T)删除指定的子节点。
RemoveSmartTags()删除所有SmartTag当前节点的后代节点。
SelectNodes(string)选择与 XPath 表达式匹配的节点列表。
SelectSingleNode(string)选择第一个Node与 XPath 表达式匹配。
ToString(SaveFormat)将节点的内容导出为指定格式的字符串。
ToString(SaveOptions)使用指定的保存选项将节点内容导出为字符串。

评论

Section可以有一个Body和最大一个HeaderFooter每个 HeaderFooterType 。Body和HeaderFooter nodes 可以按任意顺序排列Section。

最小有效部分需要具有Body有一个Paragraph。

每个部分都有自己的一组属性，指定页面大小、方向、边距等。

您可以使用以下方式创建某个部分的副本Clone该副本可以插入到 相同或不同的文档中。

要添加、插入或删除整个部分（包括分节符和 部分属性），请使用Sections目的。

要复制并插入部分内容（不包括部分 break 和部分属性），请使用AppendContent和PrependContent方法。

例子

展示如何手动构建 Aspose.Words 文档。

Document doc = new Document();

// 一个空白文档包含一个部分、一个正文和一个段落。
// 调用“RemoveAllChildren”方法删除所有节点，
// 并最终得到一个没有子节点的文档节点。
doc.RemoveAllChildren();

// 此文档现在没有可以添加内容的复合子节点。
// 如果我们想要编辑它，我们将需要重新填充它的节点集合。
// 首先，创建一个新的部分，然后将其作为子节点附加到根文档节点。
Section section = new Section(doc);
doc.AppendChild(section);

// 为该部分设置一些页面设置属性。
section.PageSetup.SectionStart = SectionStart.NewPage;
section.PageSetup.PaperSize = PaperSize.Letter;

// 一个部分需要一个主体，它将包含并显示其所有内容
// 位于页面部分页眉和页脚之间。
Body body = new Body(doc);
section.AppendChild(body);

// 创建一个段落，设置一些格式属性，然后将其作为子部分附加到正文中。
Paragraph para = new Paragraph(doc);

para.ParagraphFormat.StyleName = "Heading 1";
para.ParagraphFormat.Alignment = ParagraphAlignment.Center;

body.AppendChild(para);

// 最后，添加一些内容来执行文档。创建一个运行，
// 设置其外观和内容，然后将其作为子项附加到段落。
Run run = new Run(doc);
run.Text = "Hello World!";
run.Font.Color = Color.Red;
para.AppendChild(run);

Assert.AreEqual("Hello World!", doc.GetText().Trim());

doc.Save(ArtifactsDir + "Section.CreateManually.docx");

也可以看看

SaveFormat Enum SectionCollection Class