XmlReader.ReadElementContentAs XmlReader.ReadElementContentAs XmlReader.ReadElementContentAs XmlReader.ReadElementContentAs Method

Definición

Lee el elemento actual y devuelve el contenido como objeto del tipo especificado.Reads the current element and returns the contents as an object of the type specified.

Sobrecargas

ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver)

Lee el contenido de los elementos como el tipo solicitado.Reads the element content as the requested type.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Comprueba que el nombre local especificado y el URI de espacio de nombres coinciden con los del elemento actual y, a continuación, lee el contenido de los elementos como el tipo solicitado.Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver) ReadElementContentAs(Type, IXmlNamespaceResolver)

Lee el contenido de los elementos como el tipo solicitado.Reads the element content as the requested type.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);
public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);
abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parámetros

returnType
Type Type Type Type

Tipo del valor que se va a devolver.The type of the value to be returned.

Nota Con el lanzamiento de .NET Framework 3.5, el valor del parámetro returnType ahora puede ser el tipo DateTimeOffset.Note With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

Objeto IXmlNamespaceResolver que se utiliza para resolver prefijos de espacios de nombres relacionados con la conversión de tipo.An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

Devoluciones

Contenido de elementos convertido en el objeto con tipo solicitado.The element content converted to the requested typed object.

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.

Lea Decimal.MaxValue.Read Decimal.MaxValue.

Ejemplos

En el ejemplo siguiente se ReadElementContentAs usa el método para leer el contenido date del nodo.The following example uses the ReadElementContentAs method to read the content of the date node.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

En el ejemplo se utiliza como entrada el archivo dataFile.xml.The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

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

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Comprueba que el nombre local especificado y el URI de espacio de nombres coinciden con los del elemento actual y, a continuación, lee el contenido de los elementos como el tipo solicitado.Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

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

Parámetros

returnType
Type Type Type Type

Tipo del valor que se va a devolver.The type of the value to be returned.

Nota Con el lanzamiento de .NET Framework 3.5, el valor del parámetro returnType ahora puede ser el tipo DateTimeOffset.Note With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

Objeto IXmlNamespaceResolver que se utiliza para resolver prefijos de espacios de nombres relacionados con la conversión de tipo.An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

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

Contenido de elementos convertido en el objeto con tipo solicitado.The element content converted to the requested typed object.

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.

Lea Decimal.MaxValue.Read Decimal.MaxValue.

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