XmlTextReader.ReadString Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest den Inhalt eines Elements oder eines Textknotens als Zeichenfolge.
public:
override System::String ^ ReadString();
public override string ReadString();
override this.ReadString : unit -> string
Public Overrides Function ReadString () As String
Gibt zurück
Der Inhalt des Elements oder des Textknotens. Dies kann eine leere Zeichenfolge sein, wenn der Leser auf etwas anderes als einem Element oder Textknoten positioniert ist oder wenn im aktuellen Kontext kein Textinhalt mehr zurückgegeben werden soll.
Note: Der Textknoten kann entweder ein Element oder ein Attributtextknoten sein.
Ausnahmen
Fehler beim Analysieren des XML-Codes.
Es wurde ein ungültiger Vorgang versucht.
Beispiele
Im folgenden Beispiel wird der Textinhalt der einzelnen Elemente angezeigt.
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main()
{
XmlTextReader reader = null;
try
{
//Load the reader with the XML file.
reader = new XmlTextReader("elems.xml");
//Parse the XML and display the text content of each of the elements.
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.
}
}
}
}
finally
{
if (reader != null)
reader.Close();
}
}
} // End class
Option Strict
Option Explicit
Imports System.IO
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim reader As XmlTextReader = Nothing
Try
'Load the reader with the XML file.
reader = New XmlTextReader("elems.xml")
'Parse the XML and display the text content of each of the elements.
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()) 'Handle nested elements.
Console.WriteLine()
Console.Write("<{0}>", reader.Name)
End If
Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
End If
End If
End While
Finally
If Not (reader Is Nothing) Then
reader.Close()
End If
End Try
End Sub
End Class
Im Beispiel wird die Datei als elems.xmlEingabe verwendet.
<book>
<title>Pride And Prejudice</title>
<price>19.95</price>
<misc/>
</book>
Hinweise
Note
Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.
Wenn sie auf einem Element positioniert ist, ReadString verkettet sie alle Text-, signifikanten Leerraum-, Leer- und CData Abschnittsknotentypen zusammen und gibt die verketteten Daten als Elementinhalt zurück. Es wird angehalten, wenn markups gefunden werden, einschließlich Kommentaren und Verarbeitungsanweisungen. Dies kann in einem gemischten Inhaltsmodell oder beim Lesen eines Elementendtags auftreten.
Wenn sie auf einem Textknoten positioniert ist, ReadString führt die gleiche Verkettung vom Textknoten zum Elementendtag aus. Wenn der Leser auf einem Attributtextknoten positioniert ist, ReadString hat die gleiche Funktionalität wie die Position des Lesers auf dem Elementstarttag. Es gibt alle verketteten Elementtextknoten zurück.