Skapa nya entitetsreferenser

Metoden CreateEntityReference skapar en ny XmlEntityReference-nod . XML-dokumentobjektmodellen (DOM) ser ut att se om entitetsnamnet som refereras redan har deklarerats. Om den har gjort det kopieras de underordnade noderna i XmlEntityReference-noden från entitetsdeklarationsnoden. Om det inte finns någon entitetsdeklaration som matchar, kopplas en tom textnod som den enda underordnade till entitetsreferensnoden. Eftersom de underordnade noderna i noden XmlEntityReference är kopior av andra noder är dessa underordnade noder skrivskyddade och kan inte ändras.

När noderna kopieras kan det finnas ett namnområde i omfånget vid tidpunkten för entitetsreferensen. Det här namnområdet påverkar konfigurationen av alla element eller attributnoder som genereras.

Anmärkning

DOM lägger bara till underordnade noder i EntityReference när du infogar EntityReference-noden i dokumentet. Nyligen skapade EntityReference-noder har inga underordnade noder.

Även om XmlDataDocument är en härledd klass i XmlDocument stöder XmlDataDocument inte skapandet av entitetsreferenser. Det beror på att EntityReference-barn är skrivskyddade. Barnen till en EntityReference nod kan sträcka sig över mer än en region. I det här fallet kommer en del av en rad som är associerad med regionen och som innehåller en del av en EntityReference att vara läsas endast.

Se även

• XML-dokumentobjektmodell (DOM)