IsStartElement Method ()

XmlReader.IsStartElement Method ()

Calls MoveToContent and tests if the current content node is a start tag or empty element tag.

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

Public Overridable Function IsStartElement As Boolean
Dim instance As XmlReader
Dim returnValue As Boolean

returnValue = instance.IsStartElement
public boolean IsStartElement ()
public function IsStartElement () : boolean
Not applicable.

Return Value

true if MoveToContent finds a start tag or empty element tag; false if a node type other than XmlNodeType.Element was found.

Exception typeCondition


Incorrect XML is encountered in the input stream.

This method skips white space, comments, and processing instructions until the reader is positioned on a content node. The method then tests if the current node is an element.

The following example displays the text content of each element.

While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

The example uses the file, elems.xml, as input.

  <title>Pride And Prejudice</title>

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

© 2015 Microsoft