Section

Section class

表示文档中的单个部分。

public sealed class Section : CompositeNode

构造函数

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

特性

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

方法

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

评论

部分可以有一个Body最多一个HeaderFooter 每个HeaderFooterType. 身体页眉页脚 nodes 里面可以是任意顺序 部分.

最小有效部分需要有 身体与一个 段落.

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

您可以使用创建部分的副本Clone.副本可以插入到 相同或不同的文档中。

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

要仅复制和插入节的内容,不包括节 break 和节属性,请使用 附加内容前置内容方法。

例子

展示如何手动构建 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;

// 一个section需要一个body,它将包含并显示它的所有内容
// 在节的页眉和页脚之间的页面上。
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");

也可以看看