XmlReader.ReadContentAsString Método

Definición

Lee el contenido de texto en la posición actual como un objeto String.Reads the text content at the current position as a String object.

public:
 virtual System::String ^ ReadContentAsString();
public virtual string ReadContentAsString ();
abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string
Public Overridable Function ReadContentAsString () As String

Devoluciones

El contenido del texto como objeto String.The text content as a String object.

Excepciones

La conversión intentada no es válida.The attempted cast is not valid.

El formato de la cadena no es válido.The string format is not valid.

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentarios

Este método concatena las secciones de texto, espacio en blanco, espacio en blanco significativo y CDATA, y omite cualquier comentario o instrucción de procesamiento.This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. Las referencias de entidad se resuelven automáticamente.Entity references are automatically resolved.

Este método se puede usar para convertir valores con tipo en una cadena o para leer el contenido de texto mientras se omiten los comentarios y las instrucciones de procesamiento.This method can be used convert typed values to a string, or to read the text content while skipping comments and processing instructions.

En la tabla siguiente se describe cómo trata este método cada tipo de nodo.The following table describes how this method treats each node type.

XmlNodeTypeXmlNodeType Valor devueltoReturn value Comportamiento del sistema de lecturaReader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
El contenido concatenado de los nodos de texto, CDATA, espacio en blanco y espacio en blanco significativo se convierten en el tipo solicitado.Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. Se mueve a la siguiente etiqueta del elemento de inicio o de fin.Moves to the next start element or end element tag. Las referencias de entidad se expanden automáticamente.Entity references are automatically expanded.
Attribute Igual que llamar a XmlConvert.ToXxx en el valor del atributo.Same as calling XmlConvert.ToXxx on the attribute value. El sistema de lectura permanece en la posición actual.The reader remains in the current position.
Comment

ProcessingInstruction
Omite la instrucción de procesamiento o los comentarios y lee el contenido del texto concatenado que sigue a la instrucción de procesamiento o los comentarios.Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. Se mueve a la siguiente etiqueta del elemento de inicio o de fin.Moves to the next start element or end element tag. Las referencias de entidad se expanden automáticamente.Entity references are automatically expanded.
EndElement Una cadena vacía.An empty string. El sistema de lectura permanece en la posición actual.The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Se inicia una InvalidOperationException.An InvalidOperationException is thrown. No definido, aunque normalmente el sistema de lectura permanece en la posición actual.Undefined, although typically the reader remains in the current position.

Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader y la recomendación W3C XML Schema Part 2: Datatypes .For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Para obtener la versión asincrónica de este método, vea ReadContentAsStringAsync.For the asynchronous version of this method, see ReadContentAsStringAsync.

Se aplica a