XmlReader.ReadStartElement Method (String)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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 virtual void ReadStartElement(
	string name
)

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 (XmlReader reader = 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();

}

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: