CreateEntityReference 方法會建立新的 XmlEntityReference 節點。 XML 檔物件模型 (DOM) 會查看所參考的實體名稱是否已宣告。 如果有,則會從實體宣告節點複製 XmlEntityReference 節點的子節點。 如果沒有符合的實體宣告,空的文字節點會附加為實體參考節點的唯一子系。 因為 XmlEntityReference 節點的子節點是其他節點的複本,所以這些子節點是唯讀的,而且無法修改。
複製節點時,實體參考點的範圍中可能會有命名空間。 此命名空間會影響產生之任何專案或屬性節點的組態。
備註
只有當您將 EntityReference 節點插入檔時,DOM 才會將子節點新增至 EntityReference 。 新建立的 EntityReference 節點沒有子節點。
雖然 XmlDataDocument 是 XmlDocument 的衍生類別,但 XmlDataDocument 不支援建立實體參考。 這是因為 EntityReference 子系是唯讀的。 EntityReference 節點的子系可以跨越多個區域。 在此情況下,與包含 EntityReference 部分之區域相關聯的數據列部分將會是只讀的。