CreateEntityReference 方法创建新的 XmlEntityReference 节点。 XML 文档对象模型(DOM)将查看所引用的实体名称是否已声明。 如果是这样,XmlEntityReference 节点的子节点将从实体声明节点复制过来。 如果没有匹配的实体声明,则空文本节点将附加为实体引用节点的唯一子级。 由于 XmlEntityReference 节点的子节点是其他节点的副本,因此这些子节点是只读的,不能修改。
当复制节点时,在实体引用所处的范围内可能存在一个命名空间。 此命名空间会影响生成的任何元素或属性节点的配置。
注释
仅当将 EntityReference 节点插入文档时,DOM 才会向 EntityReference 添加子节点。 新创建的 EntityReference 节点没有子节点。
尽管 XmlDataDocument 是 XmlDocument 的派生类,但 XmlDataDocument 不支持创建实体引用。 这是因为 EntityReference 子级是只读的。 EntityReference 节点的子级可以跨越多个区域。 在这种情况下,行中与包含 EntityReference 一部分的区域关联的部分是只读的。