共用方式為


建立新實體參考

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

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

注意

只有在您將 EntityReference 節點插入文件時,DOM 才會將子節點加入 EntityReference。 新建的 EntityReference 節點沒有子節點。

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

另請參閱