创建新实体引用

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

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

注释

仅当将 EntityReference 节点插入文档时,DOM 才会向 EntityReference 添加子节点。 新创建的 EntityReference 节点没有子节点。

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

另请参阅