XmlReader.ReadContentAsObject 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 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 -> objPublic Overridable Function ReadContentAsObject () As ObjectDevoluciones
El contenido de texto como el objeto de Common Language Runtime (CLR) más adecuado.
Excepciones
La conversión intentada no es válida.
El formato de la cadena no es válido.
Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica 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 el contenido se escribe, 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 con conversión boxed 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, se considera que el contenido no está escrito.
Si el contenido no tiene tipo, el sistema de lectura lo devuelve como una cadena.
En la tabla siguiente se describe cómo trata este método cada tipo de nodo.
| Tipo XmlNode | Valor devuelto | Comportamiento del sistema de lectura |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
El contenido concatenado de los nodos de texto, CDATA, espacio en blanco y espacio en blanco significativo se convierten en el tipo solicitado. | Se mueve a la siguiente etiqueta del elemento de inicio o de fin. 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 |
CommentProcessingInstruction |
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. | Se mueve a la siguiente etiqueta del elemento de inicio o de fin. Las referencias de entidad se expanden automáticamente. |
EndElement |
Valor del elemento si el lector es un lector de validación de esquema (ValidationType se establece en Schema); de lo contrario, una cadena vacía. | El sistema de lectura permanece en la posición actual. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Se inicia una InvalidOperationException. | No definido, aunque normalmente el sistema de lectura 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.