XmlReader.ResolveEntity Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

When overridden in a derived class, resolves the entity reference for EntityReference nodes.

Namespace:  System.Xml
Assembly:  System.Xml (in System.Xml.dll)

Syntax

'Declaration
Public MustOverride Sub ResolveEntity
public abstract void ResolveEntity()

Exceptions

Exception Condition
InvalidOperationException

The reader is not positioned on an EntityReference node; this implementation of the reader cannot resolve entities (CanResolveEntity returns false).

Remarks

If the reader is positioned on an EntityReference node (XmlNodeType.EntityReference), if Read is called after calling this method, the entity replacement text is parsed. When the entity replacement text is finished, an EndEntity node is returned to close the entity reference scope.

NoteNote:

After calling this method, if the entity is part of an attribute value, you must call ReadAttributeValue to step into the entity.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.