XmlReader.ReadStartElement Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Überprüft, ob der aktuelle Knoten ein Element ist, und rückt den Reader zum nächsten Knoten vor.

Überlädt

ReadStartElement()	Überprüft, ob der aktuelle Knoten ein Element ist, und rückt den Reader zum nächsten Knoten vor.
ReadStartElement(String)	Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen Name ist, und verschiebt den Reader auf den nächsten Knoten.
ReadStartElement(String, String)	Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen LocalName und dem angegebenen NamespaceURI ist, und verschiebt den Reader auf den nächsten Knoten.

ReadStartElement()

Überprüft, ob der aktuelle Knoten ein Element ist, und rückt den Reader zum nächsten Knoten vor.

public:
 virtual void ReadStartElement();

public virtual void ReadStartElement ();

abstract member ReadStartElement : unit -> unit
override this.ReadStartElement : unit -> unit

Public Overridable Sub ReadStartElement ()

Ausnahmen

XmlException

Im Eingabestream wurde unzulässiger XML-Code gefunden.

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

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

Siehe auch

• ReadEndElement()

ReadStartElement(String)

Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen Name ist, und verschiebt den Reader auf den nächsten Knoten.

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

XmlException

Im Eingabestream wurde unzulässiger XML-Code gefunden.

- oder -

Der Name des Elements entspricht nicht dem angegebenen name.

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im folgenden Beispiel wird der Textinhalt jedes Elements 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 an Read.

Siehe auch

• ReadEndElement()

ReadStartElement(String, String)

Überprüft, ob der aktuelle Inhaltsknoten ein Element mit dem angegebenen LocalName und dem angegebenen NamespaceURI ist, und verschiebt den Reader auf den nächsten Knoten.

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

XmlException

Im Eingabestream wurde unzulässiger XML-Code gefunden.

- oder -

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

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

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

Siehe auch

• ReadEndElement()