Aspose.Words Document Object Model (DOM)

那个 Aspose.Words Document Object Model (单位:千美元)DOM)是Word文档的内在代表. 那个 Aspose.Words DOM 允许您在程序上读取、操作和修改Word文档的内容和格式。

本节介绍 Aspose.Words DOM 还有他们的关系通过使用 Aspose.Words DOM 中,您可以获取对文档元素和格式化的程序访问。

创建文档对象树

当文档读入 Aspose.Words <span notrans="<span notrans=" DOM"="">",> 然后构建对象树,源文档的不同类型元素有自己的 DOM 具有各种属性的树形对象。

构建文档节点树

何时 Aspose.Words 将 Word 文档读入内存,它创建了代表各种文档元素的不同类型对象。文本,段落,表,或节的每次运行都是节点,甚至文档本身也是节点. Aspose.Words 定义每个文档节点类型的类。

文档树 Aspose.Words 遵循复合设计模式:

所有节点类最终都来自 Node 类,是 Aspose.Words Document Object Model。。。。
能够包含其他节点的节点,例如, Section 或 Paragraph, 来源于 CompositeNode 分类,反过来又源于 Node 课。

下图显示各节点之间的继承情况。 Aspose.Words Document Object Model (单位:千美元)DOM) (中文(简体) ). 抽象类的名称在斜体语中.

那个 Aspose.Words DOM 还包含非节点类,例如: Style 或 Font, 用于定制文档中的外观和样式。本图中未显示这些类未从 Node 课。

举个例子以下图像显示 Microsoft Word 有不同类型内容的文档。

将上述文档读入 Aspose.Words DOM, 创建对象的树,如下图所示。

Document, Section, Paragraph, Table, Shape, Run, 和图上的所有其他椭圆是 Aspose.Words 代表 Word 文档元素的对象。

拿一个 `Node` 类型

虽然 Node 分类足以区分不同的节点, Aspose.Words 提供 NodeType 引用以简化一些 API 任务,例如选择特定类型的节点。

每个节点的类型可以使用 NodeType 属性。此财产返回 a NodeType 计数值. 例如,以 Paragraph 类返回 NodeType。。。。Paragraph,并用 Table 类返回 NodeType。。。。Table。。。。

以下示例显示如何使用 NodeType 计数:

Aspose.Words 代表作为节点树的文档,它允许您在节点之间导航。本节介绍如何在 Aspose.Words。。。。

当您打开早先在文档浏览器中展示的样本文档时,节点树就和它所代表的完全一样 Aspose.Words。。。。

您可以在此学习" Document Explorer" 样本项目 Aspose.Words GitHub。。。。

文档节点关系

树上的节点有它们之间的关系:

含有另一个节点的节点是 parent.
怎么样? 父节点中的节点是 child. 同一父母的孩子节点 sibling 节点。
那个 root 节点总是 Document 节点.

能够包含其他节点的节点来自 CompositeNode 分类,所有节点最终都来自 Node 课。这两个基类为树结构导航和修改提供了共同的方法和属性.

以下UML对象图显示了样本文档的几个节点及其通过父母,孩子和兄弟姐妹属性彼此间的关系:

文档为节点所有者

一个节点总是属于某个特定文档,即使它刚刚被创建或从树上移除,因为样式和列表等重要的全文档结构都存储在其中. Document 节点. 例如,不可能有一个 Paragraph 无 Document 因为每个段落都有指定的样式,该样式为文档全球定义。创建任何新节点时都会使用此规则. 添加新内容 Paragraph 直接发送给 DOM 需要向构建器传递文档对象。

那个 Node.Document 属性返回节点所属的文档。

使用新段落创建时 DocumentBuilder, 建造者总是有 Document 分类通过 DocumentBuilder.Document 属性。

以下代码示例显示,在创建任何节点时,将拥有节点的文档总是被定义:

父节点

每个节点都有由 ParentNode 属性。一个节点没有父节点,即, ParentNode 在下列情况下无效:

怎么样? 节点刚刚建立,尚未加入树上.
怎么样? 节点已被树除去.
怎么样? 这是根 Document 总是有父节点的节点。

您可以通过调用: Remove 方法。以下代码示例显示如何访问父节点:

子节点

访问儿童节点的最有效方式 CompositeNode 是经过 FirstChild 和 LastChild 属性分别返回第一个和最后一个子节点。如果没有子节点,这些属性返回 null。。。。

CompositeNode 还提供了 ChildNodes 用于索引或列出儿童节点访问的集合。那个 ChildNodes 属性是节点的活集,这意味着当文档被更改时,例如节点被删除或添加时, ChildNodes 自动更新收藏。

如果一个节点没有孩子,那么 ChildNodes 属性返回空收藏。您可以检查是否 CompositeNode 包含任何使用 HasChildNodes 属性。

以下代码示例说明如何列出一个直接的孩子节点 CompositeNode 使用 ChildNodes 收藏库:

以下代码示例说明如何列出一个直接的孩子节点 CompositeNode 使用索引访问:

兄弟姐妹节点

您可以使用 PreviousSibling 和 NextSibling 属性。如果一个节点是其父母最后一个孩子,那么 NextSibling 属性是 null。。。相反,如果节点是其父母的第一个孩子,则 PreviousSibling 属性是 null。。。。

以下代码示例显示如何高效访问复合节点的所有直接和间接的儿童节点:

儿童和父母节点的输入

目前为止,我们已经讨论过返回其中一种碱性类型的属性。 Node 或 CompositeNode。。。但有时你可能需要将数值投向特定节点类,例如: Run 或 Paragraph。。。也就是说,你无法完全摆脱铸造与工作 Aspose.Words DOM, 这是复合的。

为了减少铸造需求,大多数 Aspose.Words 类提供属性和收藏,提供强烈类型的访问。输入访问有三种基本模式:

父节点显示输入 FirstXXX 和 LastXXX 属性。例如, Document 已经 FirstSection 和 LastSection 属性。同样, Table 有属性,例如 FirstRow, LastRow, 还有其他人。
父母的节点会显示儿童节点的打字集,例如: Document.Sections, Body.Paragraphs, 还有其他人。
儿童节点提供与其父母的打字机会,例如: Run.ParentParagraph, Paragraph.ParentSection, 还有其他人。

类型属性只是有用的快捷键,有时比从中继承的通用属性更容易访问 Node.ParentNode 和 CompositeNode.FirstChild。。。。

以下代码示例显示如何使用打字属性访问文档树的节点:

翻译 Markdown 改为 DOM