XmlTextReader.ReadString Método

Definição

Lê o conteúdo de um elemento ou um nó de texto como uma cadeia de caracteres.Reads the contents of an element or a text node as a string.

public:
 override System::String ^ ReadString();
public override string ReadString ();
override this.ReadString : unit -> string
Public Overrides Function ReadString () As String

Retornos

String

O conteúdo do nó de elemento ou de texto.The contents of the element or text node. Essa poderá ser uma cadeia de caracteres vazia se o leitor estiver posicionado em algo diferente de um elemento ou nó de texto ou, se não houver nenhum outro conteúdo de texto para retornar no contexto atual.This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context.

Note: O nó de texto pode ser um elemento ou um nó de texto do atributo.Note: The text node can be either an element or an attribute text node.

Exceções

Erro ao analisar o XML.An error occurred while parsing the XML.

Ocorreu uma tentativa de uma operação inválida.An invalid operation was attempted.

Exemplos

O exemplo a seguir exibe o conteúdo de texto de cada elemento.The following example displays the text content of each element.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = nullptr;
   try
   {
      
      //Load the reader with the XML file.
      reader = gcnew 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 != nullptr )
            reader->Close();
   }

}

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

O exemplo usa o arquivo, elems.xml , como entrada.The example uses the file, elems.xml, as input.


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

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Se estiver posicionado em um elemento, ReadString concatena todo o texto, o espaço em branco significativo, o espaço em branco e os CData tipos de nó de seção juntos e retorna os dados concatenados como o conteúdo do elemento.If positioned on an element, ReadString concatenates all text, significant white space, white space, and CData section node types together and returns the concatenated data as the element content. Ele para quando qualquer marcação é encontrada, incluindo comentários e instruções de processamento.It stops when any markup is encountered, including comments and processing instructions. Isso pode ocorrer em um modelo de conteúdo misto ou quando uma marca de fim de elemento for lida.This could occur in a mixed content model, or when an element end tag is read.

Se posicionado em um nó de texto, ReadString o executará a mesma concatenação do nó de texto para a marca de fim do elemento.If positioned on a text node, ReadString performs the same concatenation from the text node to the element end tag. Se o leitor for posicionado em um nó de texto de atributo, o ReadString terá a mesma funcionalidade de um leitor posicionado na marca de início de elemento.If the reader is positioned on an attribute text node, ReadString has the same functionality as if the reader were position on the element start tag. Ele retornará todos os nós de texto de elemento concatenados.It returns all the concatenated element text nodes.

Aplica-se a

Confira também