XmlNodeReader.ReadString Methode

Definition

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 textähnlichen Knotens (Dies kann CDATA, Textknoten usw.) enthalten. 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.

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()
  {
    XmlNodeReader reader = null;

    try
    {
       //Create and load the XML document.
       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<book>" +
                   "<title>Pride And Prejudice</title>" +
                   "<price>19.95</price>" +
                   "<misc/>" +
                   "</book>");

       //Load the XmlNodeReader
       reader = new XmlNodeReader(doc);

       //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 XmlNodeReader = Nothing
        
        Try
            'Create and load the XML document.
            Dim doc As New XmlDocument()
            doc.LoadXml("<book>" & _
                        "<title>Pride And Prejudice</title>" & _
                        "<price>19.95</price>" & _
                        "<misc/>" & _
                        "</book>")
            
            'Load the XmlNodeReader 
            reader = New XmlNodeReader(doc)
            
            '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

Hinweise

Note

Um neuere Features nutzen zu können, empfiehlt es sich, Instanzen mithilfe der XmlReader Klasse und der XmlReaderSettings Methode zu erstellenCreate. Weitere Informationen finden Sie im Abschnitt "Hinweise" auf der XmlReader Referenzseite.

Wenn sie auf einem Element positioniert ist, ReadString verkettet sie den gesamten Text, bedeutenden Leerraum, Leerzeichen und CData-Abschnittsknotentypen zusammen und gibt die verketteten Daten als Elementinhalt zurück. Es wird angehalten, wenn markups gefunden werden. Dies kann in einem gemischten Inhaltsmodell oder beim Lesen eines Elementendtags auftreten.

Wenn die Position auf einem textähnlichen Knoten erfolgt, ReadString führt die gleiche Verkettung vom Textknoten zum Elementendetag 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.

Gilt für: