• Article

XmlReader.ReadElementContentAs Method (Type, IXmlNamespaceResolver, String, String)

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

Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

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

Syntax

'Declaration
Public Overridable Function ReadElementContentAs ( _
    returnType As Type, _
    namespaceResolver As IXmlNamespaceResolver, _
    localName As String, _
    namespaceURI As String _
) As Object

public virtual Object ReadElementContentAs(
    Type returnType,
    IXmlNamespaceResolver namespaceResolver,
    string localName,
    string namespaceURI
)

Parameters

  • returnType
    Type: System.Type
    The type of the value to be returned.
    Note    With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.
  • namespaceURI
    Type: System.String
    The namespace URI of the element.

Return Value

Type: System.Object
The element content converted to the requested typed object.

Exceptions

Exception Condition
InvalidOperationException

The XmlReader is not positioned on an element.
XmlException

The current element contains child elements.

-or-

The element content cannot be converted to the requested type.
ArgumentNullException

The method is called with nulla null reference (Nothing in Visual Basic) arguments.
ArgumentException

The specified local name and namespace URI do not match that of the current element being read.
OverflowException

Read Decimal.MaxValue.

Remarks

This method reads the start tag, the contents of the element, and moves the reader past the end element tag. It expands entities and ignores processing instructions and comments. The element can only contain simple content. That is, it cannot have child elements.

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.