14.5 Eigenschaften und Methoden der Klasse »XmlReader«
Einige Eigenschaften und Methoden der Klasse XmlReader kennen Sie bereits. In diesem Abschnitt sollen auch die bisher nicht erwähnten genannt werden. Der besseren Übersicht wegen sind die Methoden und Eigenschaften nach Funktion bzw. Verhalten gruppiert.
Navigation mit dem »XmlReader«
Methoden | Beschreibung |
IsStartElement |
Überprüft, ob der aktuelle Inhaltsknoten ein Starttag ist. Intern wird dabei MoveToContent() aufgerufen. |
MoveToContent |
Enthält der aktuelle Knoten keine Daten, werden alle folgenden Whitespaces, Kommentare usw. so lange übersprungen, bis die Methode auf einen Knoten mit Daten stößt. |
Read |
Die Methode springt zum folgenden XML-Knoten. Der Rückgabewert ist true, wenn noch ein weiteres XML-Element gelesen werden kann. |
ReadToDescendant("Element") |
Die Methode setzt den XmlReader auf das nächste XML-Element, das dem aktuellen XML-Element untergeordnet ist. Wird kein passendes gefunden, wird der XmlReader auf das nächste Startelement gesetzt. Dazu ein Beispiel. Hat das XML-Dokument die Struktur <a><b><c></c></b></a><d></d> und steht der Reader aktuell auf Element a, wird die Anweisung reader.ReadToDescendant("b") erfolgreich sein, während die Anweisung reader.ReadToDescendant("d") als Ergebnis false liefert. |
ReadToFollowing("Element") |
Liest, bis ein Element mit dem angegebenen qualifizierten Namen gefunden wird, z. B.: reader.ReadToFollowing("Person") Der Rückgabewert ist true, wenn ein übereinstimmendes Element gefunden wird. |
ReadToNextSibling("Element") |
Die Methode setzt den Reader auf das nächste XML-Element, das sich auf derselben Hierarchieebene wie das aktuelle Element befindet. Wird kein passendes Element gefunden, wird der Reader auf das Endelement des übergeordneten Elements gesetzt. |
Skip |
Die Methode überspringt den Inhalt des aktuellen XML-Elements und aller darin enthaltenen untergeordneten Elemente. |
Eigenschaften und Methoden im Zusammenhang mit Attributen
Methoden/Eigenschaften | Beschreibung |
AttributeCount |
(Eigenschaft) Liefert die Anzahl der Attribute des aktuellen XML-Elements. |
HasAttributes |
(Eigenschaft) Gibt an, ob das aktuelle Element Attribute hat. |
MoveToFirstAttribute |
Methode, die zum ersten Attribut des aktuellen XML-Elements springt. |
MoveToNextAttribute |
Methode, die zum nächsten Attribut des aktuellen XML-Elements springt. |
MoveToAttribute |
Methode, die zum angegebenen Attribut des aktuellen Elements springt, beispielsweise: reader.MoveToAttribute("Ort") |
MoveToElement |
Methode, die von der Ebene der Attribute zurück zur Elementebene springt. |
Eigenschaften und Methoden im Zusammenhang mit Namespaces
Methode/Eigenschaft | Beschreibung |
LocalName |
Eigenschaft, die den Elementnamen liefert, jedoch ohne Präfix. |
LookupNamespace |
Liefert den Namespace-URI zum angegebenen Präfix, z. B.: reader.LookupNamespace("a") |
Name |
Eigenschaft, die den Element- oder Attributbezeichner liefert, einschließlich des vorangestellten Präfixes. |
NamespaceURI |
Liefert den Namespace-URI zum aktuellen Element. |
Prefix |
Diese Eigenschaft liefert das Präfix des aktuellen XML-Elements. |
ReadXxx |
Diese Methode liest das durch Name und Namespace-URI spezifizierte XML-Element. |
Daten lesen
Methode | Beschreibung |
ReadContentAsXxxx |
Diese Methode liefert den Inhalt von Knoten (z. B. CDATA, Text etc.), wenn diese einen solchen haben können. Ausgeschlossen sind allerdings XML-Elemente. Dabei wird der Inhalt im gewünschten Datentyp gelesen, z. B. als ReadContentAsString oder ReadContentAsInt. Anschließend wird der Reader auf den nächsten Knoten gesetzt. |
ReadElementContentAsXxx |
Liefert den Inhalt des aktuellen XML-Elements im gewünschten Datentyp. Die Methode ist allerdings nur auf XML-Elementen anwendbar, die selbst keine Unterelemente haben. Anschließend wird der Reader auf den nächsten Knoten gesetzt. |
ReadElementString |
Diese Methode liest einfache Nur-Text-Elemente. Sie ruft MoveToContent auf, um den nächsten Inhaltsknoten zu suchen, und analysiert dann dessen Wert als einfache Zeichenfolge. |
ReadString |
Liefert den Inhalt des aktuellen Knotens als Zeichenfolge. |
ReadInnerXml |
Diese Methode gibt den gesamten Inhalt des aktuellen Knotens zurück. Der aktuelle Knoten (Starttag) und der entsprechende Endknoten (Endtag) werden nicht zurückgegeben. |
ReadOuterXml |
Diese Methode gibt den gesamten aktuellen Knoten zurück, einschließlich des Start- und Endtags. |
Ihre Meinung
Wie hat Ihnen das Openbook gefallen? Wir freuen uns immer über Ihre Rückmeldung. Schreiben Sie uns gerne Ihr Feedback als E-Mail an kommunikation@rheinwerk-verlag.de.