XmlReader.ReadElementContentAsLong Method

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

Reads the current element and returns the contents as a 64-bit signed integer.

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

Syntax

'Declaration
Public Overridable Function ReadElementContentAsLong As Long
public virtual long ReadElementContentAsLong()

Return Value

Type: System.Int64
The element content as a 64-bit signed integer.

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 a 64-bit signed integer.

ArgumentNullException

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

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.

Examples



Dim output As New StringBuilder()


Dim xmlString As String = _
            "<root>" & _
            "<stringValue><!--comment-->" & _
            "<?some pi?>text value of the element." & _
            "</stringValue>" & _
            "<longValue>270000000000001</longValue><number>0</number>" & _
            "<double>2E10</double><date>2003-01-08T15:00:00-00:00</date>" & _
            "</root>"

Using reader As XmlReader = XmlReader.Create(New StringReader(xmlString))
    reader.ReadToFollowing("longValue")
    Dim number As Long = reader.ReadElementContentAsLong()
    output.AppendLine(number.ToString())
End Using

OutputTextBlock.Text = output.ToString()



StringBuilder output = new StringBuilder();

String xmlString =
    @"<root>
    <stringValue>
    <!--comment-->
    <?some pi?>
        text value of the element.
    </stringValue>
    <longValue>270000000000001</longValue>
    <number>0</number>
    <double>2E10</double>
    <date>2003-01-08T15:00:00-00:00</date>
</root>";

using (XmlReader reader = XmlReader.Create(new StringReader(xmlString)))
{
    reader.ReadToFollowing("longValue");
    long number = reader.ReadElementContentAsLong();
    output.AppendLine(number.ToString());
}

OutputTextBlock.Text = output.ToString();

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.