XmlReader.ReadElementContentAs Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Lê o elemento atual e retorna o conteúdo como um objeto do tipo especificado.

Sobrecargas

ReadElementContentAs(Type, IXmlNamespaceResolver)	Lê o conteúdo do elemento como o tipo solicitado.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual e, em seguida, lê o conteúdo do elemento atual como o tipo solicitado.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Origem:

XmlReader.cs

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

O tipo do valor a ser retornado.

Observação Com a versão do .NET Framework 3.5, o valor do parâmetro returnType agora pode ser do tipo DateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

Um objeto IXmlNamespaceResolver que é usado para resolver todos os prefixos de namespace relacionados à conversão de tipo.

Retornos

Object

O conteúdo do elemento convertido para o objeto de tipo solicitado.

Exceções

InvalidOperationException

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

- ou -

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

XmlException

O elemento atual contém elementos filho.

- ou -

Não é possível converter o conteúdo do elemento no tipo solicitado.

ArgumentNullException

O método é chamado com os argumentos null.

OverflowException

Leia o Decimal.MaxValue.

Exemplos

O exemplo a seguir usa o ReadElementContentAs método para ler o conteúdo do date nó.

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

O exemplo usa o arquivo dataFile.xml 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>

Comentários

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

Para obter mais informações, consulte a seção Comentários da página de XmlReader referência e a recomendação W3C XML Schema Part 2: Datatypes .

Para obter a versão assíncrona desse método, consulte ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Origem:

XmlReader.cs

Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual e, em seguida, lê o conteúdo do elemento atual como o 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

O tipo do valor a ser retornado.

Observação Com a versão do .NET Framework 3.5, o valor do parâmetro returnType agora pode ser do tipo DateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

Um objeto IXmlNamespaceResolver que é usado para resolver todos os prefixos de namespace relacionados à conversão de tipo.

localName

String

O nome local do elemento.

namespaceURI

String

O URI do namespace do elemento.

Retornos

Object

O conteúdo do elemento convertido para o objeto de tipo solicitado.

Exceções

InvalidOperationException

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

- ou -

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

XmlException

O elemento atual contém elementos filho.

- ou -

Não é possível converter o conteúdo do elemento no tipo solicitado.

ArgumentNullException

O método é chamado com os argumentos null.

ArgumentException

O nome do local especificado e o URI de namespace não correspondem àqueles do elemento atual que está sendo lido.

OverflowException

Leia o Decimal.MaxValue.

Comentários

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

Para obter mais informações, consulte a seção Comentários da página de XmlReader referência e a recomendação W3C XML Schema Part 2: Datatypes .