XmlTextReader.ReadString Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XmlTextReader.cs

Legge il contenuto di un elemento o di un nodo di testo come stringa.

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

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

Valori restituiti

String

Contenuto dell'elemento o del nodo di testo. Può trattarsi di una stringa vuota se il lettore è posizionato su un elemento diverso da un elemento o un nodo di testo o se non è presente più contenuto di testo da restituire nel contesto corrente.

Note: Il nodo di testo può essere un elemento o un nodo di testo dell'attributo.

Eccezioni

XmlException

Errore durante l'analisi del codice XML.

InvalidOperationException

Tentativo di un'operazione non valida.

Esempio

Nell'esempio seguente viene visualizzato il contenuto di testo di ogni elemento.

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

Nell'esempio viene usato il file , elems.xml, come input.

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

Commenti

Note

È consigliabile creare XmlReader istanze usando il XmlReader.Create metodo per sfruttare le nuove funzionalità.

Se posizionato su un elemento, ReadString concatena tutti i tipi di testo, spazi vuoti significativi, spazi vuoti e CData nodi di sezione insieme e restituisce i dati concatenati come contenuto dell'elemento. Si arresta quando viene rilevato un markup, inclusi i commenti e le istruzioni di elaborazione. Questo problema può verificarsi in un modello di contenuto misto o quando viene letto un tag di fine elemento.

Se posizionato in un nodo di testo, ReadString esegue la stessa concatenazione dal nodo di testo al tag di fine elemento. Se il lettore è posizionato su un nodo di testo dell'attributo, ReadString ha la stessa funzionalità di se il lettore fosse posizionato sul tag iniziale dell'elemento. Restituisce tutti i nodi di testo dell'elemento concatenati.

Vedi anche

• XmlReader