XmlReader.ReadStartElement Method (String)

 

Checks that the current content node is an element with the given Name and advances the reader to the next node.

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

Public Overridable Sub ReadStartElement (
	name As String
)

Parameters

name
Type: System.String

The qualified name of the element.

Exception Condition
XmlException

Incorrect XML was encountered in the input stream.

-or-

The Name of the element does not match the given name.

InvalidOperationException

An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”

A call to this method corresponds to a call to IsStartElement followed by a call to Read.

The following example displays the text content of each element.

Using reader As XmlReader = XmlReader.Create("book3.xml")               
  ' Parse the XML document.  ReadString is used to 
  ' read the text content of the elements.
  reader.Read()
  reader.ReadStartElement("book")
  reader.ReadStartElement("title")
  Console.Write("The content of the title element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadStartElement("price")
  Console.Write("The content of the price element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadEndElement()            
End Using

The example uses the book3.xml file.

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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: