创建新实体引用

更新：November 2007

CreateEntityReference 方法创建新的 XmlEntityReference 节点。 XML 文档对象模型 (DOM) 查看是否已声明了引用的实体名称。 如果已声明，则从实体声明节点复制 XmlEntityReference 节点的子节点。 如果没有匹配的实体声明，则附加一个空的文本节点作为实体引用节点的唯一子级。 由于 XmlEntityReference 节点的子节点是其他节点的副本，因此这些子节点是只读的，无法修改。

当复制节点时，在实体引用所处的范围内可能存在一个命名空间。 此命名空间影响生成的任何元素或属性节点的配置。

说明：
仅当将 EntityReference 节点插入到文档中时，DOM 才将子节点添加到 EntityReference。 新创建的 EntityReference 节点没有子节点。

尽管 XmlDataDocument 是 XmlDocument 的派生类，但 XmlDataDocument 不支持实体引用的创建。 这是因为 EntityReference 子级是只读的。 EntityReference 节点的子级可以跨一个以上的区域。 在这种情况下，行中与包含 EntityReference 一部分的区域关联的部分将是只读的。

请参见

概念

XML 文档对象模型 (DOM)