Nieuwe entiteitsverwijzingen maken
Met de methode CreateEntityReference wordt een nieuw XmlEntityReference-knooppunt gemaakt . Het XML Document Object Model (DOM) ziet er naar of de entiteitsnaam waarnaar wordt verwezen, al is gedeclareerd. Als dat zo is, worden de onderliggende knooppunten van het XmlEntityReference-knooppunt gekopieerd uit het knooppunt voor entiteitsdeclaratie. Als er geen entiteitsdeclaratie is die overeenkomt, wordt een leeg tekstknooppunt gekoppeld als het enige onderliggende element van het entiteitsreferentieknooppunt. Omdat de onderliggende knooppunten van het knooppunt XmlEntityReference kopieën van andere knooppunten zijn, zijn deze onderliggende knooppunten alleen-lezen en kunnen ze niet worden gewijzigd.
Wanneer de knooppunten worden gekopieerd, is er mogelijk een naamruimte binnen het bereik op het punt van de entiteitsreferentie. Deze naamruimte is van invloed op de configuratie van elementen of kenmerkknooppunten die worden gegenereerd.
Notitie
De DOM voegt alleen onderliggende knooppunten toe aan entityReference wanneer u het knooppunt EntityReference invoegt in het document. Nieuw gemaakte EntityReference-knooppunten hebben geen onderliggende knooppunten.
Hoewel xmlDataDocument een afgeleide klasse van het XmlDocument is, biedt het XmlDataDocument geen ondersteuning voor het maken van entiteitsverwijzingen. Dit komt doordat onderliggende entiteiten van EntityReference alleen-lezen zijn. De onderliggende elementen van een EntityReference-knooppunt kunnen meerdere regio's omvatten. In dit geval wordt een deel van een rij die is gekoppeld aan de regio die een deel van een EntityReference bevat, alleen-lezen.
