Lesen von Inhalten
Aktualisiert: November 2007
Die XmlReader-Klasse enthält Member, die zum Lesen von Inhalten verwendet werden können.
.gif "Hinweis") Hinweis: |
|---|
Die in diesem Thema beschriebenen Member geben Inhalte als Zeichenfolgenwerte zurück. Wenn Sie typisierte Inhalte lesen möchten, finden Sie unter Lesen von typisierten Daten weitere diesbezügliche Informationen. |
Value-Eigenschaft
Mit der Value-Eigenschaft kann der Textinhalt des aktuellen Knotens abgerufen werden. Der zurückgegebene Wert hängt vom Knotentyp des aktuellen Knotens ab. In der folgenden Tabelle werden die Inhalte beschrieben, die für die möglichen Knotentypen zurückgegeben werden.
Knotentyp |
Wert |
|---|---|
Attribute |
Der Wert des Attributs. |
CDATA |
Der Inhalt des CDATA-Abschnitts. |
Comment |
Der Inhalt des Kommentars. |
DocumentType |
Die interne Teilmenge. |
ProcessingInstruction |
Der gesamte Inhalt mit Ausnahme des Ziels. |
SignificantWhitespace |
Der Leerraum zwischen Markup bei einem gemischten Inhaltsmodell. |
Text |
Der Inhalt des Textknotens. |
Whitespace |
Der Leerraum zwischen Markup. |
XmlDeclaration |
Der Inhalt der Deklaration. |
Alle anderen Knotentypen. |
Eine leere Zeichenfolge. |
ReadString-Methode
Die ReadString-Methode gibt den Inhalt eines Element- oder Textknotens als Zeichenfolge zurück.
Wenn der XmlReader auf einem Element positioniert ist, verkettet ReadString alle Textknoten, Knoten mit signifikantem Leerraum, Leerraumknoten und CDATA-Abschnittsknoten und gibt die verketteten Daten als Elementinhalt zurück. Der Reader wird angehalten, sobald er auf Markup trifft. Dies könnte in einem Modell mit gemischtem Inhalt vorkommen oder wenn das Endtag eines Elements gelesen wird.
Wenn der XmlReader auf einem Textknoten positioniert ist, führt ReadString dieselbe Verkettung von Textknoten, Knoten mit signifikantem Leerraum, Leerraumknoten und CDATA-Abschnittsknoten durch. Der Reader wird beim ersten Knoten angehalten, der keinem der zuvor genannten Typen angehört. Wenn der Reader auf einem Attributtextknoten positioniert ist, verfügt ReadString über dieselben Funktionen wie bei einer Positionierung des Readers auf dem Starttag eines Elements. Alle verketteten Elementtextknoten werden zurückgegeben.
| Hinweis: |
|---|
Die ReadString-Methode wird bei Verarbeitungsanweisungen und Kommentaren angehalten. Sie werden nicht ignoriert. |
ReadInnerXml-Methode
Die ReadInnerXml-Methode gibt den gesamten Inhalt des aktuellen Knotens einschließlich Markup zurück. Der aktuelle Knoten (Starttag) und der entsprechende Endknoten (Endtag) werden nicht zurückgegeben. Bei der XML-Zeichenfolge <node>this<child id="123"/></node> würde ReadInnerXml z. B. this<child id="123"/> zurückgeben.
In der folgenden Tabelle wird die Behandlung von Element- und Attributknoten beschrieben.
Knotentyp |
Anfangs- position |
XML-Fragment |
Rückgabe- wert |
Position nach |
|---|---|---|---|---|
Element |
Auf dem item1-Starttag. |
<item1>text1</item1><item2>text2</item2> |
text1 |
Auf dem item2-Starttag. |
Attribut |
Auf dem attr1-Attributknoten. |
<item attr1="val1" attr2="val2">text</item> |
val1 |
Verbleibt auf dem attr1-Attributknoten. |
Wenn der Reader auf einem Endknoten positioniert ist, entspricht das Aufrufen von ReadInnerXml dem Aufrufen von Read.
ReadOuterXml-Methode
Die ReadOuterXml-Methode gibt den gesamten XML-Inhalt (einschließlich Markup) des aktuellen Knotens sowie aller untergeordneten Elemente zurück. Das Verhalten ist dem von ReadInnerXml ähnlich, außer dass auch die Start- und Endtags zurückgegeben werden.
Wenn der Reader auf dem item1-Starttag positioniert ist, gibt ReadOuterXml unter Verwendung der Werte in obiger Tabelle <item1>text1</item1> zurück. Wenn der Reader auf dem attr1-Attributknoten positioniert ist, gibt ReadOuterXmlattr1="val1" zurück.