XmlReader.ReadElementContentAs Método

Definição

Lê o elemento atual e retorna o conteúdo como um objeto do tipo especificado.Reads the current element and returns the contents as an object of the type specified.

Sobrecargas

ReadElementContentAs(Type, IXmlNamespaceResolver)

Lê o conteúdo do elemento como o tipo solicitado.Reads the element content as the requested type.

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

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

O tipo do valor a ser retornado.The type of the value to be returned.

Observação Com a versão do .NET Framework 3.5, o valor do parâmetro returnType agora pode ser do 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

Um objeto IXmlNamespaceResolver que é usado para resolver todos os prefixos de namespace relacionados à conversão de tipo.An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

Retornos

Object

O conteúdo do elemento convertido para o objeto de tipo solicitado.The element content converted to the requested typed object.

Exceções

O XmlReader não está posicionado em um elemento.The XmlReader is not positioned on an element.

- ou --or-

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O elemento atual contém elementos filho.The current element contains child elements.

- ou --or-

Não é possível converter o conteúdo do elemento no tipo solicitado.The element content cannot be converted to the requested type.

O método é chamado com os argumentos null.The method is called with null arguments.

Leia o Decimal.MaxValue.Read Decimal.MaxValue.

Exemplos

O exemplo a seguir usa o ReadElementContentAs método para ler o conteúdo do date nó.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

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

Comentários

Esse método lê a marca de início, o conteúdo do elemento e move o leitor após a marca do elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Ele expande as entidades e ignora as instruções e os comentários de processamento.It expands entities and ignores processing instructions and comments. O elemento só pode conter conteúdo simples.The element can only contain simple content. Ou seja, ele não pode ter elementos filho.That is, it cannot have child elements.

Para obter mais informações, consulte a seção comentários da XmlReader página de referência e o esquema XML do W3C parte 2: recomendação dos tipos de dados.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Para obter a versão assíncrona desse método, consulte ReadElementContentAsAsync .For the asynchronous version of this method, see ReadElementContentAsAsync.

Aplica-se a

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

O tipo do valor a ser retornado.The type of the value to be returned.

Observação Com a versão do .NET Framework 3.5, o valor do parâmetro returnType agora pode ser do 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

Um objeto IXmlNamespaceResolver que é usado para resolver todos os prefixos de namespace relacionados à conversão de tipo.An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

localName
String

O nome local do elemento.The local name of the element.

namespaceURI
String

O URI do namespace do elemento.The namespace URI of the element.

Retornos

Object

O conteúdo do elemento convertido para o objeto de tipo solicitado.The element content converted to the requested typed object.

Exceções

O XmlReader não está posicionado em um elemento.The XmlReader is not positioned on an element.

- ou --or-

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

O elemento atual contém elementos filho.The current element contains child elements.

- ou --or-

Não é possível converter o conteúdo do elemento no tipo solicitado.The element content cannot be converted to the requested type.

O método é chamado com os argumentos null.The method is called with null arguments.

O nome do local especificado e o URI de namespace não correspondem àqueles do elemento atual que está sendo lido.The specified local name and namespace URI do not match that of the current element being read.

Leia o Decimal.MaxValue.Read Decimal.MaxValue.

Comentários

Esse método lê a marca de início, o conteúdo do elemento e move o leitor após a marca do elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Ele expande as entidades e ignora as instruções e os comentários de processamento.It expands entities and ignores processing instructions and comments. O elemento só pode conter conteúdo simples.The element can only contain simple content. Ou seja, ele não pode ter elementos filho.That is, it cannot have child elements.

Para obter mais informações, consulte a seção comentários da XmlReader página de referência e o esquema XML do W3C parte 2: recomendação dos tipos de dados.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Aplica-se a