XmlReader.ReadElementContentAs 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 elemento actual y devuelve el contenido como un objeto del tipo especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| ReadElementContentAs(Type, IXmlNamespaceResolver) |
Lee el contenido del elemento como el tipo solicitado. |
| ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) |
Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el contenido del elemento como el tipo solicitado. |
ReadElementContentAs(Type, IXmlNamespaceResolver)
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
Lee el contenido del elemento 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 -> objPublic Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As ObjectParámetros
- returnType
- Type
Tipo del valor que se va a devolver.
Nota Con la versión de .NET Framework 3.5, el valor del returnType parámetro ahora puede ser el DateTimeOffset tipo.
- namespaceResolver
- IXmlNamespaceResolver
Objeto IXmlNamespaceResolver que se usa para resolver los prefijos de espacio de nombres relacionados con la conversión de tipos.
Devoluciones
Contenido del elemento convertido en el objeto con tipo solicitado.
Excepciones
No XmlReader se coloca en un elemento .
O bien
Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".
El elemento actual contiene elementos secundarios.
O bien
El contenido del elemento no se puede convertir al tipo solicitado.
Se llama al método con null argumentos.
Lee 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 usa el dataFile.xml archivo como entrada.
<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 esquema XML de W3C, parte 2: Tipos de datos .
Para obtener la versión asincrónica de este método, vea ReadElementContentAsAsync.
Se aplica a
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el contenido del elemento 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 -> objPublic Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As ObjectParámetros
- returnType
- Type
Tipo del valor que se va a devolver.
Nota Con la versión de .NET Framework 3.5, el valor del returnType parámetro ahora puede ser el DateTimeOffset tipo.
- namespaceResolver
- IXmlNamespaceResolver
Objeto IXmlNamespaceResolver que se usa para resolver los prefijos de espacio de nombres relacionados con la conversión de tipos.
- localName
- String
Nombre local del elemento.
- namespaceURI
- String
Identificador URI del espacio de nombres del elemento.
Devoluciones
Contenido del elemento convertido en el objeto con tipo solicitado.
Excepciones
No XmlReader se coloca en un elemento .
O bien
Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".
El elemento actual contiene elementos secundarios.
O bien
El contenido del elemento no se puede convertir al tipo solicitado.
Se llama al método con null argumentos.
El nombre local especificado y el URI del espacio de nombres no coinciden con el del elemento actual que se está leyendo.
Lee 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 esquema XML de W3C, parte 2: Tipos de datos .
