Esta documentación está archivada y no tiene mantenimiento.

XmlReader.ReadString (Método)

Actualización: noviembre 2007

Cuando se reemplaza en una clase derivada, lee el contenido de un nodo de elemento o de texto como una cadena.

Espacio de nombres:  System.Xml
Ensamblado:  System.Xml (en System.Xml.dll)

public virtual string ReadString()
public String ReadString()
public function ReadString() : String

Valor devuelto

Tipo: System.String
El contenido del elemento o una cadena vacía.

ExcepciónCondición
XmlException

Se ha producido un error al analizar el fragmento de XML.

Este método devuelve el contenido de los nodos de elemento, texto, espacio en blanco, espacio en blanco significativo o CDATA.

Si está situado en un elemento, ReadString concatena todos los nodos de texto, espacio en blanco significativo, espacio en blanco y sección CDATA y devuelve los datos concatenados como contenido del elemento. Se detiene cuando se encuentra código de marcado, incluidos los comentarios y las instrucciones de procesamiento. Esto podría producirse en un modelo de contenido mixto o cuando se lee una etiqueta de cierre de elemento.

Si está situado en un nodo de texto de elemento, ReadString lleva a cabo la misma concatenación desde el nodo de texto hasta la etiqueta de cierre de elemento. Si el lector está situado en un nodo de texto de atributo, ReadString tiene la misma funcionalidad que si el lector estuviera situado en la etiqueta de apertura de elemento. Devuelve todos los nodos de texto de elemento concatenados.

Si está situado en un atributo, ReadString devuelve una cadena vacía y devuelve el lector al elemento que posee el atributo.

Si se llama a ReadString en cualquier otro tipo de nodo, devuelve una cadena vacía y el lector se sitúa en el nodo siguiente.

En el siguiente ejemplo se muestra el contenido de texto de cada elemento.

using (XmlReader reader = XmlReader.Create("book3.xml")) {

  // Parse the XML document.  ReadString is used to 
  // read the text content of the elements.
  reader.Read(); 
  reader.ReadStartElement("book");  
  reader.ReadStartElement("title");   
  Console.Write("The content of the title element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadStartElement("price");
  Console.Write("The content of the price element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadEndElement();

}


En el ejemplo, se utiliza el archivo book3.xml.

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


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 2.0, 1.0
Mostrar: