Esta documentación está archivada y no tiene mantenimiento.

XmlReader.ReadElementContentAsObject (Método)

Actualización: noviembre 2007

Lee el elemento actual y devuelve el contenido como objeto Object.

Espacio de nombres:  System.Xml
Ensamblado:  System.Xml (en System.Xml.dll)

public virtual Object ReadElementContentAsObject()
public Object ReadElementContentAsObject()
public function ReadElementContentAsObject() : Object

Valor devuelto

Tipo: System.Object
Objeto de Common Language Runtime (CLR) del tipo más adecuado al que se le ha aplicado la conversión boxing. La propiedad ValueType determina el tipo CLR adecuado. Si el contenido se escribe como tipo de lista, este método devuelve una matriz de objetos del tipo adecuado a los que se les ha aplicado la conversión boxing.

ExcepciónCondición
InvalidOperationException

El XmlReader no está situado en ningún elemento.

XmlException

El elemento actual contiene elementos secundarios.

-O bien-

El contenido del elemento no se puede convertir en el tipo solicitado.

ArgumentNullException

Se llama al método con argumentos null.

Este método lee la etiqueta de apertura, el contenido del elemento y coloca el lector detrás de la etiqueta de cierre del elemento. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento sólo puede contener contenido sencillo. Es decir, no puede tener elementos secundarios.

Para obtener más información, vea el documento Lectura de datos de tipo y la recomendación W3C XML Schema Part 2: Datatypes (en inglés).

En el ejemplo siguiente, se utiliza el método para leer el contenido del nodo price. El lector utiliza la información del esquema para asignar el contenido al tipo de datos correcto.

// Create a validating reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:items", "item.xsd");	
 XmlReader reader = XmlReader.Create("item.xml", settings); 

// Get the CLR type of the price element. 
reader.ReadToFollowing("price");
Console.WriteLine(reader.ValueType);

// Return the value of the price element as Decimal object.
Decimal price = (Decimal) reader.ReadElementContentAsObject();

// Add 2.50 to the price.
price = Decimal.Add(price, 2.50m);



En el ejemplo se utilizan los dos archivos siguientes como entrada.

item.xml

<item xmlns="urn:items" productID='123098'>
 <name>hammer</name>
 <price>9.95</price>
 <supplierID>1929</supplierID>
</item>


item.xsd

<?xml version="1.0"?>
<xs:schema xmlns:tns="urn:items" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:items" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="item">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="name" type="xs:string" />
        <xs:element name="price" type="xs:decimal" />
        <xs:element name="supplierID" type="xs:unsignedShort" />
      </xs:sequence>
      <xs:attribute name="productID" type="xs:unsignedInt" use="required" />
    </xs:complexType>
  </xs:element>
</xs:schema>


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0

.NET Compact Framework

Compatible con: 3.5, 2.0

XNA Framework

Compatible con: 2.0, 1.0
Mostrar: