XmlReader.ReadStartElement Method

Definition

Checks that the current node is an element and advances the reader to the next node.

Overloads

ReadStartElement()

Checks that the current node is an element and advances the reader to the next node.

ReadStartElement(String)

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

ReadStartElement(String, String)

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

ReadStartElement()

Checks that the current node is an element and advances the reader to the next node.

public:
 virtual void ReadStartElement();
public virtual void ReadStartElement ();
abstract member ReadStartElement : unit -> unit
override this.ReadStartElement : unit -> unit
Public Overridable Sub ReadStartElement ()

Exceptions

Incorrect XML was encountered in the input stream.

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."

Remarks

This method calls IsStartElement followed by Read to position you on the content of that element found in the input stream.

See also

ReadStartElement(String)

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

public:
 virtual void ReadStartElement(System::String ^ name);
public virtual void ReadStartElement (string name);
abstract member ReadStartElement : string -> unit
override this.ReadStartElement : string -> unit
Public Overridable Sub ReadStartElement (name As String)

Parameters

name
String

The qualified name of the element.

Exceptions

Incorrect XML was encountered in the input stream.

-or-

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

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."

Examples

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();

}
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>

Remarks

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

See also

ReadStartElement(String, String)

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

public:
 virtual void ReadStartElement(System::String ^ localname, System::String ^ ns);
public virtual void ReadStartElement (string localname, string ns);
abstract member ReadStartElement : string * string -> unit
override this.ReadStartElement : string * string -> unit
Public Overridable Sub ReadStartElement (localname As String, ns As String)

Parameters

localname
String

The local name of the element.

ns
String

The namespace URI of the element.

Exceptions

Incorrect XML was encountered in the input stream.

-or-

The LocalName and NamespaceURI properties of the element found do not match the given arguments.

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."

Remarks

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

See also

Applies to