XmlReader.ReadElementContentAs Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Lee el elemento actual y devuelve el contenido como objeto del tipo especificado.

Sobrecargas

ReadElementContentAs(Type, IXmlNamespaceResolver)	Lee el contenido de los elementos como el tipo solicitado.
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.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Source:

XmlReader.cs

Lee el contenido de los elementos como el tipo solicitado.

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

Tipo del valor que se va a devolver.

Nota Con el lanzamiento de .NET Framework 3.5, el valor del parámetro returnType ahora puede ser el tipo DateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

Objeto IXmlNamespaceResolver que se utiliza para resolver prefijos de espacios de nombres relacionados con la conversión de tipos.

Devoluciones

Object

Contenido de elementos convertido en el objeto con tipo solicitado.

Excepciones

InvalidOperationException

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

o bien

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”.

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.

OverflowException

Lea Decimal.MaxValue.

Ejemplos

En el ejemplo siguiente se usa el ReadElementContentAs método para leer el contenido del date nodo.

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.

<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 inicio, el contenido del elemento y mueve el lector más allá de la etiqueta de elemento final. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento solo puede contener contenido simple. Es decir, no puede tener elementos secundarios.

Para obtener más información, vea la sección Comentarios de la XmlReader página de referencia y la recomendación W3C XML Schema Part 2: Datatypes .

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

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Source:

XmlReader.cs

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.

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

Tipo del valor que se va a devolver.

Nota Con el lanzamiento de .NET Framework 3.5, el valor del parámetro returnType ahora puede ser el tipo DateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

Objeto IXmlNamespaceResolver que se utiliza para resolver prefijos de espacios de nombres relacionados con la conversión de tipos.

localName

String

Nombre local del elemento.

namespaceURI

String

Identificador URI de espacio de nombres del elemento.

Devoluciones

Object

Contenido de elementos convertido en el objeto con tipo solicitado.

Excepciones

InvalidOperationException

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

o bien

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”.

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.

ArgumentException

El nombre local y el identificador URI del espacio de nombres especificados no coinciden con los del elemento que se está leyendo.

OverflowException

Lea Decimal.MaxValue.

Comentarios

Este método lee la etiqueta de inicio, el contenido del elemento y mueve el lector más allá de la etiqueta de elemento final. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento solo puede contener contenido simple. Es decir, no puede tener elementos secundarios.

Para obtener más información, vea la sección Comentarios de la XmlReader página de referencia y la recomendación W3C XML Schema Part 2: Datatypes .