XmlReader.ReadStartElement Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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()
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
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
Applies to
ReadStartElement(String)
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
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
Applies to
ReadStartElement(String, String)
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für