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 se zkopírují 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 v bodě odkazu na entitu existovat obor názvů v oboru. 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 podřízené položky 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 přidružená k oblasti, která obsahuje část EntityReference , jen pro čtení.

Viz také

• Model DOM (Document Object Model) dokumentu XML