XmlReader.ReadElementContentAsObject Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
netstandard.dll

Lê o elemento atual e devolve o conteúdo como um Object.

Sobrecargas

Name Description
ReadElementContentAsObject()

Lê o elemento atual e devolve o conteúdo como um Object.
ReadElementContentAsObject(String, String)

Verifica se o nome local especificado e o URI do espaço de nomes correspondem ao do elemento atual, depois lê o elemento atual e devolve o conteúdo como um Object.

ReadElementContentAsObject()

Lê o elemento atual e devolve o conteúdo como um 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

Devoluções

Object

Um objeto de execução em linguagem comum (CLR) em caixa do tipo mais apropriado. A ValueType propriedade determina o tipo de CLR apropriado. Se o conteúdo for digitado como tipo de lista, este método devolve um array de objetos em caixa do tipo apropriado.

Exceções

InvalidOperationException

O XmlReader não está posicionado sobre um elemento.

-ou-

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

XmlException

O elemento atual contém elementos filhos.

-ou-

O conteúdo do elemento não pode ser convertido para o tipo solicitado

ArgumentNullException

O método é chamado com null argumentos.

Exemplos

O exemplo seguinte utiliza o método para ler o conteúdo do price nó. O leitor utiliza a informação do esquema para mapear o conteúdo para o tipo de dado correto.

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

O exemplo utiliza os dois ficheiros seguintes 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>

Observações

Este método lê a etiqueta inicial, o conteúdo do elemento e move o leitor para além da etiqueta do elemento final. Expande entidades e ignora instruções e comentários de processamento. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filhos.

Para mais informações, consulte a secção Observações da XmlReader página de referência e a recomendação do Esquema XML do W3C Parte 2: Tipos de dados .

Para a versão assíncrona deste método, veja ReadElementContentAsObjectAsync.

Aplica-se a

ReadElementContentAsObject(String, String)

Verifica se o nome local especificado e o URI do espaço de nomes correspondem ao do elemento atual, depois lê o elemento atual e devolve o conteúdo como um 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

O nome local do elemento.

namespaceURI
String

O URI do namespace do elemento.

Devoluções

Object

Um objeto de execução em linguagem comum (CLR) em caixa do tipo mais apropriado. A ValueType propriedade determina o tipo de CLR apropriado. Se o conteúdo for digitado como tipo de lista, este método devolve um array de objetos em caixa do tipo apropriado.

Exceções

InvalidOperationException

O XmlReader não está posicionado sobre um elemento.

-ou-

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

XmlException

O elemento atual contém elementos filhos.

-ou-

O conteúdo do elemento não pode ser convertido para o tipo solicitado.

ArgumentNullException

O método é chamado com null argumentos.

ArgumentException

O nome local especificado e o URI do espaço de nomes não correspondem ao do elemento atual a ser lido.

Observações

Este método lê a etiqueta inicial, o conteúdo do elemento e move o leitor para além da etiqueta do elemento final. Expande entidades e ignora instruções e comentários de processamento. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filhos.

Para mais informações, consulte a secção Observações da XmlReader página de referência e a recomendação do Esquema XML do W3C Parte 2: Tipos de dados .

Aplica-se a