XmlReader.ReadElementContentAsObject XmlReader.ReadElementContentAsObject XmlReader.ReadElementContentAsObject XmlReader.ReadElementContentAsObject Method

Definición

Lee el elemento actual y devuelve el contenido como objeto Object.Reads the current element and returns the contents as an Object.

Sobrecargas

ReadElementContentAsObject() ReadElementContentAsObject() ReadElementContentAsObject() ReadElementContentAsObject()

Lee el elemento actual y devuelve el contenido como objeto Object.Reads the current element and returns the contents as an Object.

ReadElementContentAsObject(String, String) ReadElementContentAsObject(String, String) ReadElementContentAsObject(String, String) ReadElementContentAsObject(String, String)

Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto Object.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as an Object.

ReadElementContentAsObject() ReadElementContentAsObject() ReadElementContentAsObject() ReadElementContentAsObject()

Lee el elemento actual y devuelve el contenido como objeto Object.Reads the current element and returns the contents as an Object.

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

Devoluciones

Objeto de Common Language Runtime (CLR) del tipo más adecuado al que se le ha aplicado la conversión boxing.A boxed common language runtime (CLR) object of the most appropriate type. La propiedad ValueType determina el tipo CLR adecuado.The ValueType property determines the appropriate CLR type. 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.If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type.

Excepciones

El XmlReader no está situado en ningún elemento.The XmlReader is not positioned on an element.

o bien-or- 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."

El elemento actual contiene elementos secundarios.The current element contains child elements.

o bien-or-

El contenido del elemento no se puede convertir en el tipo solicitado.The element content cannot be converted to the requested type

Se llama al método con argumentos null.The method is called with null arguments.

Ejemplos

En el ejemplo siguiente se usa el método para leer el contenido price del nodo.The following example uses the method to read the content of the price node. El lector usa la información del esquema para asignar el contenido al tipo de datos correcto.The reader uses the information in the schema to map the content to the correct data type.

// 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);

' Create a validating reader.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:items", "item.xsd")
Dim reader As XmlReader = 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.
Dim price As [Decimal] = CType(reader.ReadElementContentAsObject(), [Decimal])
      
' Add 2.50 to the price.
price = [Decimal].Add(price, 2.5D)

En el ejemplo se usan los dos archivos siguientes como entrada.The example uses the following two files as input.

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>

Comentarios

Este método lee la etiqueta de apertura, el contenido del elemento y desplaza el lector más allá de la etiqueta del elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Expande las entidades y omite las instrucciones de procesamiento y los comentarios.It expands entities and ignores processing instructions and comments. El elemento solo puede contener contenido simple.The element can only contain simple content. Es decir, no puede tener elementos secundarios.That is, it cannot have child elements.

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 ReadElementContentAsObjectAsync.For the asynchronous version of this method, see ReadElementContentAsObjectAsync.

ReadElementContentAsObject(String, String) ReadElementContentAsObject(String, String) ReadElementContentAsObject(String, String) ReadElementContentAsObject(String, String)

Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto Object.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as an Object.

public:
 virtual System::Object ^ ReadElementContentAsObject(System::String ^ localName, System::String ^ namespaceURI);
public virtual object ReadElementContentAsObject (string localName, string namespaceURI);
abstract member ReadElementContentAsObject : string * string -> obj
override this.ReadElementContentAsObject : string * string -> obj
Public Overridable Function ReadElementContentAsObject (localName As String, namespaceURI As String) As Object

Parámetros

localName
String String String String

Nombre local del elemento.The local name of the element.

namespaceURI
String String String String

Identificador URI de espacio de nombres del elemento.The namespace URI of the element.

Devoluciones

Objeto de Common Language Runtime (CLR) del tipo más adecuado al que se le ha aplicado la conversión boxing.A boxed common language runtime (CLR) object of the most appropriate type. La propiedad ValueType determina el tipo CLR adecuado.The ValueType property determines the appropriate CLR type. 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.If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type.

Excepciones

El XmlReader no está situado en ningún elemento.The XmlReader is not positioned on an element.

o bien-or- 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."

El elemento actual contiene elementos secundarios.The current element contains child elements.

O bien-or-

El contenido del elemento no se puede convertir en el tipo solicitado.The element content cannot be converted to the requested type.

Se llama al método con argumentos null.The method is called with null arguments.

El nombre local y el identificador URI del espacio de nombres especificados no coinciden con los del elemento que se está leyendo.The specified local name and namespace URI do not match that of the current element being read.

Comentarios

Este método lee la etiqueta de apertura, el contenido del elemento y desplaza el lector más allá de la etiqueta del elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Expande las entidades y omite las instrucciones de procesamiento y los comentarios.It expands entities and ignores processing instructions and comments. El elemento solo puede contener contenido simple.The element can only contain simple content. Es decir, no puede tener elementos secundarios.That is, it cannot have child elements.

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.

Se aplica a