XmlReader.ReadContentAsObject Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

Lee el contenido de texto en la posición actual como .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

Object

Contenido de texto como el objeto de Common Language Runtime (CLR) más adecuado.

Excepciones

InvalidCastException

La conversión intentada no es válida.

FormatException

El formato de cadena no es válido.

InvalidOperationException

Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

Comentarios

Este método concatena texto, espacio en blanco, espacios en blanco significativos y secciones CDATA, y omite los comentarios o instrucciones de procesamiento. Las referencias de entidad se resuelven automáticamente.

Si se escribe el contenido, el lector devuelve un CLR con conversión boxing del tipo más adecuado, especificado por la ValueType propiedad . Si el contenido es un tipo de lista, el lector devuelve una matriz de objetos boxeados del tipo adecuado.

Nota:

Si se produce un error de validación al analizar el contenido y el lector es un XmlReader objeto creado por el Create método , el lector devuelve el contenido como una cadena. Es decir, cuando se produce un error de validación o una advertencia, el contenido se considera sin tipo.

Si el contenido no está escrito, el lector devuelve el contenido como una cadena.

En la tabla siguiente se describe cómo este método trata cada tipo de nodo.

XmlNodeType	Valor devuelto	Comportamiento del lector
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Contenido concatenado de texto, CDATA, espacio en blanco y nodos de espacio en blanco significativos convertidos al tipo solicitado.	Se mueve a la siguiente etiqueta de elemento de inicio o elemento final. Las referencias de entidad se expanden automáticamente.
Attribute	Igual que llamar al XmlConvert.ToXxx valor del atributo.	El lector permanece en la posición actual.
Comment ProcessingInstruction	Omite la instrucción de procesamiento (PI) o el comentario y lee el contenido de texto concatenado que sigue al PI o comentario.	Se mueve a la siguiente etiqueta de elemento de inicio o elemento final. Las referencias de entidad se expanden automáticamente.
EndElement	Valor del elemento si el lector es un lector que valida el esquema (ValidationType se establece Schemaen ); de lo contrario, una cadena vacía.	El lector permanece en la posición actual.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Se produce una InvalidOperationException excepción .	Sin definir, aunque normalmente el lector permanece en la posición actual.

Para obtener más información, vea la sección Comentarios de la XmlReader página de referencia y la recomendación esquema XML de W3C, parte 2: Tipos de datos .

Para obtener la versión asincrónica de este método, vea ReadContentAsObjectAsync.