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");
也可以看看
- class CompositeNode
- 命名空间 Aspose.Words
- 部件 Aspose.Words