IXMLDOMEntityReference

Represents an entity reference node.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.4.0");
var root, nodeEntityReference;
xmlDoc.async = false;
xmlDoc.loadXML("<root/>");
nodeEntityReference = xmlDoc.createEntityReference("nbsp");
root = xmlDoc.documentElement;
root.appendChild(nodeEntityReference);
alert(xmlDoc.xml);

Dim xmlDoc As New Msxml2.DOMDocument40
Dim root As IXMLDOMElement
Dim nodeEntityReference As IXMLDOMEntityReference
xmlDoc.async = False
xmlDoc.loadXML "<root/>"
Set nodeEntityReference = xmlDoc.createEntityReference("nbsp")
Set root = xmlDoc.documentElement
root.appendChild nodeEntityReference
MsgBox xmlDoc.xml

Remarks

If the XML parser expands entity references while building the structure model, no EntityReference objects appear in the tree.

XML does not require non-validating processors to handle external entity declarations (those made in the external subset or declared in external parameter entities). This means that parsed entities declared in the external subset need not be expanded, and therefore the replacement value of the entity might not be available. If available, the replacement value of the referenced entity appears in the child list of EntityReference.

The resolution of the children of the EntityReference (the replacement value of the referenced entity) can be evaluated. Actions such as calling the childNodes property are assumed to trigger the evaluation. Character entities are expanded by the XML parser and do not appear as entity references, but instead appear within the character text in Unicode.

Requirements

Implementation: msxml4.dll, msxml2.lib

To view reference information for Visual Basic, C/C++, or Script only, click the Language Filter button in the upper-left corner of the page.

See Also

childNodes Property | IXMLDOMNode | IXMLDOMEntityReference Members | IXMLDOMEntity | DOMDocument