This topic has not yet been rated - Rate this topic

XmlTextReader.LineNumber Property

.NET Framework 2.0

Other Versions

Gets the current line number.

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

Syntax

C++

Copy

public int LineNumber { get; }

Copy

/** @property */
public final int get_LineNumber ()

JScript

Copy

public final function get LineNumber () : int

Property Value

The current line number.

Remarks

Note
In the Microsoft .NET Framework version 2.0 release, the recommended practice is to create XmlReader instances using the System.Xml.XmlReader.Create method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is 1.

Combined with LinePosition, a value of 1,1 indicates the start of the document.

Example

The following example displays each node including its depth, line number, and line position.

C++

Copy

using System;
using System.IO;
using System.Xml;

public class Sample{

  public static void Main(){

    // Create the XML fragment to be parsed.
    string xmlFrag  = 
    @"<book> 
         <misc>
           <style>paperback</style> 
           <pages>240</pages>
         </misc> 
        </book>";

    // Create the XmlNamespaceManager.
    NameTable nt = new NameTable();
    XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);

    // Create the XmlParserContext.
    XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

    // Create the reader.
    XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context);

    // Parse the XML and display each node.
    while (reader.Read()){
       switch (reader.NodeType){
         case XmlNodeType.Element:
           Console.Write("{0} {1},{2}  ", reader.Depth, reader.LineNumber, reader.LinePosition);
           Console.WriteLine("<{0}>", reader.Name);
           break;
         case XmlNodeType.Text:
           Console.Write("{0} {1},{2}  ", reader.Depth, reader.LineNumber, reader.LinePosition);
           Console.WriteLine("  {0}", reader.Value);
           break;
         case XmlNodeType.EndElement:
           Console.Write("{0} {1},{2}  ", reader.Depth, reader.LineNumber, reader.LinePosition);
           Console.WriteLine("</{0}>", reader.Name);
           break;
       }       
    }           

    // Close the reader.
    reader.Close();      
  }
}

Copy

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        // Create the XML fragment to be parsed.
        String xmlFrag = "<book> \n" + "         <misc>\n" 
            + "           <style>paperback</style> \n" 
            + "           <pages>240</pages>\n" + "         </misc> \n" 
            + "        </book>";
        // Create the XmlNamespaceManager.
        NameTable nt = new NameTable();
        XmlNamespaceManager nsMgr = new XmlNamespaceManager(nt);
        // Create the XmlParserContext.
        XmlParserContext context = new XmlParserContext(null, nsMgr, null,
            XmlSpace.None);
        // Create the reader.
        XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element,
            context);
        // Parse the XML and display each node.
        while (reader.Read()) {
            switch (reader.get_NodeType()) {
                case XmlNodeType.Element:
                    Console.Write("{0} {1},{2}  ", System.Convert.ToString(
                        reader.get_Depth()), System.Convert.ToString(reader.
                        get_LineNumber()), System.Convert.ToString(reader.
                        get_LinePosition()));
                    Console.WriteLine("<{0}>", reader.get_Name());
                    break;

                case XmlNodeType.Text:
                    Console.Write("{0} {1},{2}  ", System.Convert.ToString(
                        reader.get_Depth()), System.Convert.ToString(reader.
                        get_LineNumber()), System.Convert.ToString(reader.
                        get_LinePosition()));
                    Console.WriteLine("  {0}", reader.get_Value());
                    break;

                case XmlNodeType.EndElement:
                    Console.Write("{0} {1},{2}  ", System.Convert.ToString(
                        reader.get_Depth()), System.Convert.ToString(reader.
                        get_LineNumber()), System.Convert.ToString(reader.
                        get_LinePosition()));
                    Console.WriteLine("</{0}>", reader.get_Name());
                    break;
            }
        }
        // Close the reader.
        reader.Close();
    } //main
} //Sample

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Reference

XmlTextReader Class
XmlTextReader Members
System.Xml Namespace

Other Resources

Reading XML with the XmlReader

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ