XmlReader.ReadStartElement Methode

Definition

Überprüft, ob der aktuelle Knoten ein Element ist und der Leser zum nächsten Knoten wechselt.

Überlädt

Name Beschreibung
ReadStartElement()

Überprüft, ob der aktuelle Knoten ein Element ist und der Leser zum nächsten Knoten wechselt.

ReadStartElement(String)

Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen Name Element ist und der Leser zum nächsten Knoten wechselt.

ReadStartElement(String, String)

Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen LocalName Element ist und NamespaceURI der Leser zum nächsten Knoten wechselt.

ReadStartElement()

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Überprüft, ob der aktuelle Knoten ein Element ist und der Leser zum nächsten Knoten wechselt.

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

Ausnahmen

Im Eingabedatenstrom wurde ein falscher XML-Code gefunden.

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Hinweise

Mit dieser Methode wird IsStartElement gefolgt von Read der Position des Inhalts dieses Elements im Eingabedatenstrom aufgerufen.

Weitere Informationen

Gilt für:

ReadStartElement(String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen Name Element ist und der Leser zum nächsten Knoten wechselt.

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)

Parameter

name
String

Der qualifizierte Name des Elements.

Ausnahmen

Im Eingabedatenstrom wurde ein falscher XML-Code gefunden.

-oder-

Das Name Element stimmt nicht mit dem angegebenen nameElement überein.

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beispiele

Im folgenden Beispiel wird der Textinhalt der einzelnen Elemente angezeigt.

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

Im Beispiel wird die book3.xml Datei verwendet.

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

Hinweise

Ein Aufruf dieser Methode entspricht einem Aufruf, IsStartElement gefolgt von einem Aufruf von Read.

Weitere Informationen

Gilt für:

ReadStartElement(String, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen LocalName Element ist und NamespaceURI der Leser zum nächsten Knoten wechselt.

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)

Parameter

localname
String

Der lokale Name des Elements.

ns
String

Der Namespace-URI des Elements.

Ausnahmen

Im Eingabedatenstrom wurde ein falscher XML-Code gefunden.

-oder-

Die LocalName eigenschaften NamespaceURI des gefundenen Elements stimmen nicht mit den angegebenen Argumenten überein.

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Hinweise

Ein Aufruf dieser Methode entspricht einem Aufruf, IsStartElement gefolgt von einem Aufruf von Read.

Weitere Informationen

Gilt für: