Microsoft XML 2.5 SDK


 

IXMLDOMEntityReference Interface

[This is preliminary documentation and subject to change.]

This interface represents an entity reference node.

IXMLDOMEntityReference Methods

This interface has no unique methods of its own, but exposes the inherited methods from the IXMLDOMNode interface.

Remarks

If the XML processor expands entity references while building the structure model, no EntityReference objects appear in the tree. XML does not require nonvalidating 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 that 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 the EntityReference object. The resolution of the children of the EntityReference object (the replacement value of the referenced entity) can be lazily evaluated. Actions such as calling the childNodes method are assumed to trigger the evaluation. Note that character entities are expanded by the XML processor and do not appear as entity references, but instead appear within the character text in Unicode.

Interface Information

Implementation Msxml.dll
Inherits from IXMLDOMNode
Header and IDL files Msxml.h, Xmldom.idl
Minimum availability Internet Explorer 5
Minimum operating systems Windows 95, Windows NT 4.0