Új entitáshivatkozások létrehozása

A CreateEntityReference metódus létrehoz egy új XmlEntityReference csomópontot . Az XML-dokumentumobjektum-modell (DOM) megvizsgálja, hogy a hivatkozott entitás neve már deklarálva van-e. Ha így van, az XmlEntityReference csomópont gyermekcsomópontjai ki lesznek másolva az entitásdeklarációs csomópontból. Ha nincs egyező entitásdeklaráció, a rendszer egy üres szöveges csomópontot csatol az entitás-referenciacsomópont egyetlen gyermekeként. Mivel az XmlEntityReference csomópont gyermekcsomópontjai más csomópontok másolatai, ezek a gyermekcsomópontok írásvédettek, és nem módosíthatók.

A csomópontok másolásakor előfordulhat, hogy az entitáshivatkozás helyén névtér található a hatókörben. Ez a névtér hatással van a létrehozott bármely elem- vagy attribútumcsomópont konfigurációjára.

Megjegyzés:

A DOM csak akkor ad hozzá gyermekcsomópontokat az EntityReference-hez , ha beszúrja az EntityReference csomópontot a dokumentumba. Az újonnan létrehozott EntityReference csomópontok nem rendelkeznek gyermekcsomópontokkal.

Annak ellenére, hogy az XmlDataDocument az XmlDocument származtatott osztálya, az XmlDataDocument nem támogatja az entitáshivatkozások létrehozását. Ennek az az oka, hogy az EntityReference gyermekei írásvédettek. Az EntityReference csomópont gyermekei több régióra is kiterjedhetnek. Ebben az esetben az EntityReference részét tartalmazó régióhoz társított sor egy része írásvédett lesz.

Lásd még

• XML-dokumentumobjektum-modell (DOM)