Article
11/17/2011

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.

namespaceResolver
Type: System.Xml.IXmlNamespaceResolver
An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

localName
Type: System.String
The local name of the element.

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.

Partager via