XmlTextReader.ReadString Methode

Definitie

Naamruimte:

System.Xml

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Bron:

XmlTextReader.cs

Leest de inhoud van een element of een tekstknooppunt als een tekenreeks.

public:
 override System::String ^ ReadString();

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

Retouren

String

De inhoud van het element of tekstknooppunt. Dit kan een lege tekenreeks zijn als de lezer is geplaatst op iets anders dan een element of tekstknooppunt, of als er geen tekstinhoud meer is om terug te keren in de huidige context.

Note: Het tekstknooppunt kan een element of een kenmerktekstknooppunt zijn.

Uitzonderingen

XmlException

Er is een fout opgetreden tijdens het parseren van de XML.

InvalidOperationException

Er is een ongeldige bewerking uitgevoerd.

Voorbeelden

In het volgende voorbeeld wordt de tekstinhoud van elk element weergegeven.

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

In het voorbeeld wordt het bestand als elems.xmlinvoer gebruikt.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

Opmerkingen

Note

Wij raden aan dat u XmlReader instanties maakt met behulp van de XmlReader.Create methode om te profiteren van nieuwe functionaliteiten.

Als deze op een element is geplaatst, ReadString voegt u alle tekst, aanzienlijke witruimte, witruimte en CData sectieknooppunttypen samen en retourneert u de samengevoegde gegevens als elementinhoud. Het stopt wanneer er markeringen worden aangetroffen, inclusief opmerkingen en verwerkingsinstructies. Dit kan gebeuren in een model voor gemengde inhoud of wanneer een elementeindtag wordt gelezen.

Als deze op een tekstknooppunt wordt weergegeven, ReadString voert u dezelfde samenvoeging uit van het tekstknooppunt naar de eindtag van het element. Als de lezer op een kenmerktekstknooppunt wordt weergegeven, ReadString heeft deze dezelfde functionaliteit als als de lezer de positie van de elementstarttag heeft. Hiermee worden alle tekstknooppunten van het samengevoegde element geretourneerd.

Zie ook

• XmlReader