建立新實體參考

更新： November 2007

CreateEntityReference 方法建立新 XmlEntityReference 節點。XML 文件物件模型 (DOM) 會查看所要參考的實體名稱是否已進行宣告。如果是，XmlEntityReference 節點的子節點會從實體宣告節點複製。如果沒有符合的實體宣告，會將空白文字節點當成實體參考節點的唯一子代附加上去。因為 XmlEntityReference 節點的子節點是其他節點的複本，因此這些子節點是唯讀的而且無法修改。

複製節點時，在實體參考的範圍可能有命名空間。這個命名空間影響任何產生的項目或屬性節點的組態。

注意事項：
只有在您將 EntityReference 節點插入文件時，DOM 才會將子節點加入 EntityReference。新建的 EntityReference 節點沒有子節點。

雖然 XmlDataDocument 是 XmlDocument 的衍生類別，但是 XmlDataDocument 卻不能建立實體參考。這是因為 EntityReference 子系是唯讀的。EntityReference 節點的子系可以擴展一個以上的區域。因此，與包含部分 EntityReference 的區域相關之資料列的部分也會是唯讀的。

請參閱

概念

XML 文件物件模型 (DOM)