XmlTextReader.ReadString Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlTextReader.cs

Egy elem vagy szövegcsomópont tartalmát sztringként olvassa be.

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

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

Válaszok

String

Az elem vagy szövegcsomópont tartalma. Ez lehet üres sztring, ha az olvasó nem elemen vagy szövegcsomóponton van elhelyezve, vagy ha nincs több szöveges tartalom, amelyet vissza szeretne adni az aktuális környezetben.

Note: A szövegcsomópont lehet elem vagy attribútum szövegcsomópont.

Kivételek

XmlException

Hiba történt az XML elemzése során.

InvalidOperationException

Érvénytelen műveletet kíséreltek meg.

Példák

Az alábbi példa az egyes elemek szöveges tartalmát jeleníti meg.

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

A példa a fájlt elems.xmlhasználja bemenetként.

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

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Ha egy elemen van elhelyezve, ReadString összefűzi az összes szöveget, a jelentős üres területet, a szabad területet és CData a szakaszcsomóponttípust, és az összefűzött adatokat adja vissza elemtartalomként. Bármely korrektúra észlelésekor leáll, beleértve a megjegyzéseket és a feldolgozási utasításokat. Ez egy vegyes tartalommodellben vagy egy elemvégcímke olvasásakor fordulhat elő.

Ha egy szövegcsomóponton van elhelyezve, ReadString ugyanazt az összefűzést hajtja végre a szövegcsomóponttól az elem zárócímkéje felé. Ha az olvasó egy attribútum szövegcsomóponton van elhelyezve, ugyanazzal a funkcióval rendelkezik, ReadString mintha az olvasó az elem kezdőcímkéjén helyezkedett volna el. Visszaadja az összes összefűzött elem szövegcsomópontot.

Lásd még

• XmlReader