XmlReader.ReadContentAsObject XmlReader.ReadContentAsObject XmlReader.ReadContentAsObject XmlReader.ReadContentAsObject Method

Definición

Lee el contenido de texto en la posición actual como Object.Reads the text content at the current position as an Object.

public:
 virtual System::Object ^ ReadContentAsObject();
public virtual object ReadContentAsObject ();
abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj
Public Overridable Function ReadContentAsObject () As Object

Devoluciones

El contenido de texto como el objeto de Common Language Runtime (CLR) más adecuado.The text content as the most appropriate common language runtime (CLR) 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.

Si se escribe el contenido, el lector devuelve un CLR con conversión boxing del tipo más apropiado, especificado por la ValueType propiedad.If the content is typed, the reader returns a boxed CLR of the most appropriate type, specified by the ValueType property. Si el contenido es un tipo de lista, el lector devuelve una matriz de objetos con conversión boxing del tipo adecuado.If the content is a list type, the reader returns an array of boxed objects of the appropriate type.

Nota

Si se produce un error de validación al analizar el contenido y el lector XmlReader es un objeto creado Create por el método, el lector devuelve el contenido como una cadena.If a validation error occurs while parsing the content and the reader is an XmlReader object created by the Create method, the reader returns the content as a string. En otras palabras, cuando se produce un error de validación o una advertencia, se considera que el contenido no tiene tipo.In other words when a validation error or warning occurs, the content is considered to be untyped.

Si el contenido no tiene tipo, el sistema de lectura lo devuelve como una cadena.If the content is not typed, the reader returns the content as a string.

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.

Tipo XmlNodeXmlNodeType 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 XmlConvert.ToXxx a en el valor del atributo.Same as calling XmlConvert.ToXxx on the attribute value. El lector permanece en la posición actualThe 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 Valor del elemento si el lector es un lector de validación de esquemasValidationType (está establecido Schemaen); de lo contrario, es una cadena vacía.The value of the element if the reader is a schema validating reader (ValidationType is set to Schema); otherwise 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 XmlReader la página de referencia y el esquema XML de W3C parte 2: Recomendación de tipos de los tipos de.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 ReadContentAsObjectAsync.For the asynchronous version of this method, see ReadContentAsObjectAsync.

Se aplica a