Exceptions

Type	Reason
InvalidOperationException	The reader is not positioned on a XmlNodeType.EntityReference node. [Edit]

Remarks

Operation

This method parses the entity reference into child nodes. When the parsing is finished a new XmlNodeType.EndEntity node is placed in the stream to close the EntityReference scope. To step into the entity after this method has been called, call the XmlReader.ReadAttributeValue method if the entity is part of an attribute value, or the XmlReader.Read method if the entity is part of element content.

If this method is not called, the parser moves to the next node past the entity (child nodes are bypassed).

Note to Inheritors

This method must be overridden in order to provide the functionality as described in the Behaviors and Usage sections, as there is no default implementation.

This method is required to throw an exception for implementations that do not support schema or DTD information. In this case, the XmlReader.CanResolveEntity property is required to return false.

Usage

Use this method to resolve the entity reference for EntityReference nodes. Before calling this method, determine whether the reader can resolve an entity by checking the XmlReader.CanResolveEntity property.

[Edit]

Requirements

Namespace: System.Xml
Assembly: System.Xml (in System.Xml.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0