Vytváření nových odkazů na entity

Metoda CreateEntityReference vytvoří nový uzel XmlEntityReference . Model DOM (Document Object Model) XML hledá, jestli již byl deklarován název entity, na který odkazujete. Pokud ano, podřízené uzly uzlu XmlEntityReference jsou zkopírovány z uzlu deklarace entity. Pokud neexistuje žádná deklarace entity, která se shoduje, připojí se prázdný textový uzel jako jediný podřízený uzel odkazu na entitu. Vzhledem k tomu, že podřízené uzly uzlu XmlEntityReference jsou kopiemi jiných uzlů, jsou tyto podřízené uzly jen pro čtení a nelze je upravovat.

Po zkopírování uzlů může být obor názvů v rozsahu v místě odkazu na entitu. Tento obor názvů má vliv na konfiguraci jakéhokoli vygenerovaného prvku nebo uzlů atributů.

Poznámka:

DoM přidá podřízené uzly do EntityReference pouze při vložení uzlu EntityReference do dokumentu. Nově vytvořené uzly EntityReference nemají žádné podřízené uzly.

I když XmlDataDocument je odvozená třída XmlDocument, XmlDataDocument nepodporuje vytváření odkazů na entity. Důvodem je to, že prvky EntityReference jsou jen pro čtení. Podřízené položky uzlu EntityReference mohou zahrnovat více než jednu oblast. V tomto případě bude část řádku spojená s oblastí, která obsahuje část EntityReference, určena pouze pro čtení.

Viz také

• Objektový model dokumentu XML (DOM)