XmlValidatingReader.ReadString Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Lee el contenido de un elemento o nodo de texto como una cadena.
public:
override System::String ^ ReadString();
public override string ReadString();
override this.ReadString : unit -> string
Public Overrides Function ReadString () As String
Devoluciones
Contenido del elemento o nodo de texto. Puede ser una cadena vacía si el lector se coloca en algo distinto de un elemento o nodo de texto, o si no hay más contenido de texto que devolver en el contexto actual.
Comentarios
El nodo de texto puede ser un elemento o un nodo de texto de atributo.
Nota:
La XmlValidatingReader clase está obsoleta en .NET Framework 2.0. Puede crear una instancia de validación XmlReader mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.
Si se coloca en un elemento, ReadString concatena todo el texto, espacios en blanco significativos, espacios en blanco y tipos de nodo de sección CDATA juntos y devuelve los datos concatenados como contenido del elemento. El lector se detiene cuando se encuentra cualquier marcado, incluidos los comentarios y las instrucciones de procesamiento. Esto puede ocurrir en un modelo de contenido mixto o cuando se lee una etiqueta final de elemento.
Si se coloca en un nodo de texto, ReadString realiza la misma concatenación del nodo de texto a la etiqueta final del elemento. Si el lector se coloca en un nodo de texto de atributo, ReadString tiene la misma funcionalidad que si el lector estuviera situado en la etiqueta de inicio del elemento. Devuelve todos los nodos de texto del elemento concatenado.
La EntityHandling propiedad determina cómo ReadString funciona de la siguiente manera:
| Importancia | Descripción |
|---|---|
| ExpandEntities | Devuelve el carácter expandido y las entidades generales. Este es el valor predeterminado. |
| ExpandCharEntities | Devuelve el contenido de texto hasta pero no incluye una referencia de entidad general. Esto significa que una entidad general hace que ReadString se detenga. Debe llamar Read a para pasar por encima de la referencia de entidad. |