XmlTextReader.ReadString Метод

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlTextReader.cs

Считывает содержимое элемента или текстового узла в виде строки.

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

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

Возвращаемое значение

String

Содержимое элемента или текстового узла. Это может быть пустая строка, если средство чтения расположено на другом элементе или текстовом узле, или если в текущем контексте нет больше текстового содержимого.

Note: Текстовый узел может быть элементом или текстовым узлом атрибута.

Исключения

XmlException

При анализе XML произошла ошибка.

InvalidOperationException

Предпринята недопустимая операция.

Примеры

В следующем примере отображается текстовое содержимое каждого элемента.

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

В этом примере файл elems.xmlиспользуется в качестве входных данных.

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

Комментарии

Note

Рекомендуем создавать XmlReader экземпляры с помощью XmlReader.Create метода, чтобы воспользоваться новыми функциями.

Если он расположен на элементе, объединяет все тексты, ReadString значительные пробелы, пробелы и типы узлов разделов вместе и CData возвращает объединенные данные в виде содержимого элемента. Он останавливается при обнаружении любой разметки, включая комментарии и инструкции по обработке. Это может произойти в смешанной модели содержимого или при чтении конечного тега элемента.

При расположении на текстовом узле ReadString выполняет то же объединение из текстового узла в конечный тег элемента. Если средство чтения размещено на текстовом узле атрибута, имеет ту же функциональность, ReadString что и средство чтения в теге запуска элемента. Он возвращает все сцепленные текстовые узлы элемента.

См. также раздел

• XmlReader