Lesen von Elementen

In der folgenden Tabelle werden die Methoden und Eigenschaften beschrieben, die die XmlReader-Klasse für Verarbeitungselemente bereitstellt. Nachdem der XmlReader auf einem Element platziert wurde, spiegeln die Knoteneigenschaften, z. B. Name, die Elementwerte wider. Zusätzlich zu den unten beschriebenen Membern können auch alle allgemeinen Methoden und Eigenschaften der XmlReader-Klasse zum Verarbeiten von Elementen verwendet werden. Sie können beispielsweise mit der ReadInnerXml-Methode den Inhalt eines Elements lesen.

Hinweis
Diese Methoden schließen einen anfänglichen Aufruf der MoveToContent-Methode ein.

Membername	Beschreibung
IsStartElement	Überprüft, ob der aktuelle Knoten ein Anfangstag oder ein leeres Elementtag ist.
ReadStartElement	Überprüft, ob der aktuelle Knoten ein Element ist, und rückt den Reader zum nächsten Knoten vor.
ReadEndElement	Überprüft, ob der aktuelle Knoten ein Endtag ist, und rückt den Reader zum nächsten Knoten vor.
ReadElementString	Liest ein Nur-Text-Element.
ReadToDescendant	Rückt den XmlReader auf das nächste untergeordnete Element mit dem angegebenen Namen vor.
ReadToNextSibling	Rückt den XmlReader auf das nächste nebengeordnete Element mit dem angegebenen Namen vor.
IsEmptyElement	Überprüft, ob das aktuelle Element ein leeres Elementtag aufweist. Diese Eigenschaft ermöglicht Ihnen, die Unterschiede zwischen den folgenden Elementen zu bestimmen: <item num="123"/> (IsEmptyElement ist true.) <item num="123"> (IsEmptyElement ist false, obwohl der Inhalt des Elements leer ist.) Das bedeutet, IsEmptyElement berichtet nur, ob das Element im Quelldokument ein Endtag aufweist oder nicht.

Beispiele

Der folgende Code liest Elemente mithilfe der ReadStartElement-Methode und der ReadString-Methode.

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

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

}

Der folgende Code verarbeitet Elemente mithilfe einer While-Schleife.

While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
    Else
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

while (reader.Read()) {
  if (reader.IsStartElement()) {
    if (reader.IsEmptyElement)
      Console.WriteLine("<{0}/>", reader.Name);
    else {
      Console.Write("<{0}> ", reader.Name);
      reader.Read(); // Read the start tag.
      if (reader.IsStartElement())  // Handle nested elements.
        Console.Write("\r\n<{0}>", reader.Name);
      Console.WriteLine(reader.ReadString());  //Read the text content of the element.
    }
  } 
} 

Siehe auch

Konzepte

Lesen von XML mit dem "XmlReader"