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)

'Declaration
Public Overridable Function IsStartElement As Boolean
'Usage
Dim instance As XmlReader
Dim returnValue As Boolean

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

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

XmlException

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)
    Else
      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.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

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.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show: