XmlTextReader Classe

Definição

Espaço de Nomes:

System.Xml

Assemblagens:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlTextReader.cs

Representa um leitor que fornece acesso rápido, não armazenado em cache e apenas avançado a dados XML.

Recomendamos que utilize a XmlReader aula em vez disso.

public ref class XmlTextReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo, System::Xml::IXmlNamespaceResolver

public class XmlTextReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

Herança

Object

XmlReader

XmlTextReader

Implementações

IXmlLineInfo IXmlNamespaceResolver

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para o XmlTextReader.

Notas para Herdeiros

Esta classe tem uma exigência de herança. O trust completo é obrigado a herdar de XmlTextReader.

Construtores

Name	Description
XmlTextReader()	Inicializa uma nova instância do XmlTextReader.
XmlTextReader(Stream, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado e XmlNameTable.
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado, XmlNodeType, e XmlParserContext.
XmlTextReader(Stream)	Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado.
XmlTextReader(String, Stream, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com o URL especificado, stream e XmlNameTable.
XmlTextReader(String, Stream)	Inicializa uma nova instância da XmlTextReader classe com o URL e stream especificados.
XmlTextReader(String, TextReader, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com a URL especificada, TextReader e XmlNameTable.
XmlTextReader(String, TextReader)	Inicializa uma nova instância da XmlTextReader classe com o URL especificado e TextReader.
XmlTextReader(String, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com o ficheiro especificado e XmlNameTable.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Inicializa uma nova instância da XmlTextReader classe com a cadeia especificada, XmlNodeType, e XmlParserContext.
XmlTextReader(String)	Inicializa uma nova instância da XmlTextReader classe com o ficheiro especificado.
XmlTextReader(TextReader, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com os especificados TextReader e XmlNameTable.
XmlTextReader(TextReader)	Inicializa uma nova instância da XmlTextReader classe com o especificado TextReader.
XmlTextReader(XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com o especificado XmlNameTable.

Propriedades

Name	Description
AttributeCount	Obtém o número de atributos no nó atual.
BaseURI	Obtém o URI base do nó atual.
CanReadBinaryContent	Recebe um valor que indica se implementa XmlTextReader os métodos binários de leitura de conteúdo.
CanReadValueChunk	Obtém um valor que indica se implementa XmlTextReader o ReadValueChunk(Char[], Int32, Int32) método.
CanResolveEntity	Recebe um valor que indica se este leitor pode analisar e resolver as entidades.
Depth	Obtém a profundidade do nó atual no documento XML.
DtdProcessing	Obtém ou define a DtdProcessing enumeração.
Encoding	Obtém a codificação do documento.
EntityHandling	Recebe ou define um valor que especifica como o leitor gere as entidades.
EOF	Recebe um valor que indica se o leitor está posicionado no final do fluxo.
HasAttributes	Recebe um valor que indica se o nó atual tem algum atributo. (Herdado de XmlReader)
HasValue	Obtém um valor que indica se o nó atual pode ter um Value diferente de String.Empty.
IsDefault	Recebe um valor que indica se o nó atual é um atributo gerado a partir do valor padrão definido no DTD ou esquema.
IsEmptyElement	Obtém um valor que indica se o nó atual é um elemento vazio (por exemplo, <MyElement/>).
Item[Int32]	Quando sobrescrito numa classe derivada, obtém o valor do atributo com o índice especificado. (Herdado de XmlReader)
Item[String, String]	Quando sobrescrito numa classe derivada, obtém o valor do atributo com o especificado LocalName e NamespaceURI. (Herdado de XmlReader)
Item[String]	Quando sobrescrito numa classe derivada, obtém o valor do atributo com o especificado Name. (Herdado de XmlReader)
LineNumber	Obtém o número da linha atual.
LinePosition	Fica com a posição atual na linha.
LocalName	Obtém o nome local do nó atual.
Name	Obtém o nome qualificado do nó atual.
Namespaces	Recebe ou define um valor que indica se deve fazer suporte a namespace.
NamespaceURI	Obtém o URI do namespace (conforme definido na especificação W3C Namespace) do nó onde o leitor está posicionado.
NameTable	Percebe o que XmlNameTable está associado a esta implementação.
NodeType	Obtém o tipo do nó atual.
Normalization	Recebe ou define um valor que indica se deve normalizar espaços em branco e valores de atributos.
Prefix	Recebe o prefixo de namespace associado ao nó atual.
ProhibitDtd	Obsoleto. Recebe ou define um valor que indica se permite o processamento DTD. Esta propriedade está obsoleta. Utilize DtdProcessing em substituição.
QuoteChar	Obtém o carácter de aspas usado para delimitar o valor de um nó de atributo.
ReadState	Percebe o estado do leitor.
SchemaInfo	Obtém a informação do esquema que foi atribuída ao nó atual como resultado da validação do esquema. (Herdado de XmlReader)
Settings	Obtém o XmlReaderSettings objeto usado para criar esta XmlReader instância. (Herdado de XmlReader)
Value	Obtém o valor de texto do nó atual.
ValueType	Obtém o tipo Common Language Runtime (CLR) para o nó atual. (Herdado de XmlReader)
WhitespaceHandling	Recebe ou define um valor que especifica como o espaço em branco é tratado.
XmlLang	Recebe o âmbito atual xml:lang .
XmlResolver	Define os XmlResolver usados para resolver referências DTD.
XmlSpace	Recebe o âmbito atual xml:space .

Métodos

Name	Description
Close()	Muda o ReadState para Closed.
Dispose()	Liberta todos os recursos usados pela instância atual da XmlReader classe. (Herdado de XmlReader)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo XmlReader e opcionalmente liberta os recursos geridos. (Herdado de XmlReader)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetAttribute(Int32)	Obtém o valor do atributo com o índice especificado.
GetAttribute(String, String)	Obtém o valor do atributo com o nome local especificado e o URI do espaço de nomes.
GetAttribute(String)	Obtém o valor do atributo com o nome especificado.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetNamespacesInScope(XmlNamespaceScope)	Obtém uma coleção que contém todos os namespaces atualmente no âmbito.
GetRemainder()	Fica com o restante do XML em buffer.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValueAsync()	De forma assíncrona, obtém-se o valor do nó atual. (Herdado de XmlReader)
HasLineInfo()	Recebe um valor que indica se a classe pode devolver informação de linha.
IsStartElement()	Chama MoveToContent() e testa se o nó de conteúdo atual é uma tag de início ou uma tag de elemento vazio. (Herdado de XmlReader)
IsStartElement(String, String)	Chamadas MoveToContent() e testes se o nó de conteúdo atual é uma etiqueta inicial ou uma etiqueta de elemento vazio e se as LocalName propriedades e NamespaceURI do elemento encontrado correspondem às strings dadas. (Herdado de XmlReader)
IsStartElement(String)	Chamadas MoveToContent() e testes se o nó de conteúdo atual é uma etiqueta inicial ou uma etiqueta de elemento vazia e se a Name propriedade do elemento encontrado corresponde ao argumento dado. (Herdado de XmlReader)
LookupNamespace(String)	Resolve um prefixo de namespace no âmbito do elemento atual.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MoveToAttribute(Int32)	Move-se para o atributo com o índice especificado.
MoveToAttribute(String, String)	Move-se para o atributo com o nome local especificado e o espaço de nomes URI.
MoveToAttribute(String)	Move-se para o atributo com o nome especificado.
MoveToContent()	Verifica se o nó atual é um nó de conteúdo (texto sem espaço em branco, CDATA, Element, EndElementEntityReference, , ou EndEntity) . Se o nó não for um nó de conteúdo, o leitor avança para o próximo nó de conteúdo ou para o fim do ficheiro. Ignora nós do seguinte tipo: ProcessingInstruction, DocumentType, Comment, Whitespace, ou SignificantWhitespace. (Herdado de XmlReader)
MoveToContentAsync()	Verifica assíncronamente se o nó atual é um nó de conteúdo. Se o nó não for um nó de conteúdo, o leitor avança para o próximo nó de conteúdo ou para o fim do ficheiro. (Herdado de XmlReader)
MoveToElement()	Move-se para o elemento que contém o nó de atributo atual.
MoveToFirstAttribute()	Passa para o primeiro atributo.
MoveToNextAttribute()	Passa para o atributo seguinte.
Read()	Lê o próximo nó do fluxo.
ReadAsync()	Lê assíncronamente o próximo nó do fluxo. (Herdado de XmlReader)
ReadAttributeValue()	Analisa o valor do atributo em um ou mais Text, EntityReference, ou EndEntity nós.
ReadBase64(Byte[], Int32, Int32)	Descodifica o Base64 e devolve os bytes binários decodificados.
ReadBinHex(Byte[], Int32, Int32)	Descodifica BinHex e retorna os bytes binários decodificados.
ReadChars(Char[], Int32, Int32)	Lê o conteúdo do texto de um elemento num buffer de caracteres. Este método foi concebido para ler grandes fluxos de texto incorporado, chamando-os sucessivamente.
ReadContentAs(Type, IXmlNamespaceResolver)	Lê o conteúdo como um objeto do tipo especificado. (Herdado de XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Lê assíncronamente o conteúdo como um objeto do tipo especificado. (Herdado de XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Lê o conteúdo e devolve os Base64 bytes binários decodificados.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Lê assíncronamente o conteúdo e devolve os bytes binários decodificados em Base64. (Herdado de XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Lê o conteúdo e devolve os BinHex bytes binários decodificados.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Lê assíncronamente o conteúdo e devolve os BinHex bytes binários decodificados. (Herdado de XmlReader)
ReadContentAsBoolean()	Lê o conteúdo do texto na posição atual como um Boolean. (Herdado de XmlReader)
ReadContentAsDateTime()	Lê o conteúdo do texto na posição atual como um DateTime objeto. (Herdado de XmlReader)
ReadContentAsDateTimeOffset()	Lê o conteúdo do texto na posição atual como um DateTimeOffset objeto. (Herdado de XmlReader)
ReadContentAsDecimal()	Lê o conteúdo do texto na posição atual como um Decimal objeto. (Herdado de XmlReader)
ReadContentAsDouble()	Lê o conteúdo do texto na posição atual como um número de ponto flutuante de dupla precisão. (Herdado de XmlReader)
ReadContentAsFloat()	Lê o conteúdo do texto na posição atual como um número de ponto flutuante de precisão simples. (Herdado de XmlReader)
ReadContentAsInt()	Lê o conteúdo do texto na posição atual como um inteiro com sinal de 32 bits. (Herdado de XmlReader)
ReadContentAsLong()	Lê o conteúdo do texto na posição atual como um inteiro assinado de 64 bits. (Herdado de XmlReader)
ReadContentAsObject()	Lê o conteúdo do texto na posição atual como um Object. (Herdado de XmlReader)
ReadContentAsObjectAsync()	Lê assíncronamente o conteúdo do texto na posição atual como um Object. (Herdado de XmlReader)
ReadContentAsString()	Lê o conteúdo do texto na posição atual como um String objeto. (Herdado de XmlReader)
ReadContentAsStringAsync()	Lê assíncronamente o conteúdo do texto na posição atual como um String objeto. (Herdado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Verifica se o nome local especificado e o URI do espaço de nomes correspondem ao do elemento atual, depois lê o conteúdo do elemento como o tipo solicitado. (Herdado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Lê o elemento conteúdo como o tipo solicitado. (Herdado de XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Lê assíncronamente o conteúdo do elemento como o tipo solicitado. (Herdado de XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Lê o elemento e decodifica o conteúdo do Base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Lê assíncronamente o elemento e decodifica o Base64 conteúdo. (Herdado de XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Lê o elemento e decodifica o BinHex conteúdo.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Lê assíncronamente o elemento e decodifica o BinHex conteúdo. (Herdado de XmlReader)
ReadElementContentAsBoolean()	Lê o elemento atual e devolve o conteúdo como um Boolean objeto. (Herdado de XmlReader)
ReadElementContentAsBoolean(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 Boolean objeto. (Herdado de XmlReader)
ReadElementContentAsDateTime()	Lê o elemento atual e devolve o conteúdo como um DateTime objeto. (Herdado de XmlReader)
ReadElementContentAsDateTime(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 DateTime objeto. (Herdado de XmlReader)
ReadElementContentAsDecimal()	Lê o elemento atual e devolve o conteúdo como um Decimal objeto. (Herdado de XmlReader)
ReadElementContentAsDecimal(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 Decimal objeto. (Herdado de XmlReader)
ReadElementContentAsDouble()	Lê o elemento atual e devolve o conteúdo como um número de ponto flutuante de dupla precisão. (Herdado de XmlReader)
ReadElementContentAsDouble(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 número de ponto flutuante de dupla precisão. (Herdado de XmlReader)
ReadElementContentAsFloat()	Lê o elemento atual e devolve o conteúdo como número de ponto flutuante de precisão simples. (Herdado de XmlReader)
ReadElementContentAsFloat(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 número de ponto flutuante de precisão simples. (Herdado de XmlReader)
ReadElementContentAsInt()	Lê o elemento atual e devolve o conteúdo como um inteiro com sinal de 32 bits. (Herdado de XmlReader)
ReadElementContentAsInt(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 inteiro assinado de 32 bits. (Herdado de XmlReader)
ReadElementContentAsLong()	Lê o elemento atual e devolve o conteúdo como um inteiro assinado de 64 bits. (Herdado de XmlReader)
ReadElementContentAsLong(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 inteiro assinado de 64 bits. (Herdado de XmlReader)
ReadElementContentAsObject()	Lê o elemento atual e devolve o conteúdo como um Object. (Herdado de XmlReader)
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. (Herdado de XmlReader)
ReadElementContentAsObjectAsync()	Lê assíncronamente o elemento atual e devolve o conteúdo como um Object. (Herdado de XmlReader)
ReadElementContentAsString()	Lê o elemento atual e devolve o conteúdo como um String objeto. (Herdado de XmlReader)
ReadElementContentAsString(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 String objeto. (Herdado de XmlReader)
ReadElementContentAsStringAsync()	Lê assíncronamente o elemento atual e devolve o conteúdo como um String objeto. (Herdado de XmlReader)
ReadElementString()	Lê um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString() método, pois oferece uma forma mais direta de lidar com esta operação. (Herdado de XmlReader)
ReadElementString(String, String)	Verifica se as LocalName propriedades e NamespaceURI do elemento encontrado correspondem às strings dadas antes de ler um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString(String, String) método, pois oferece uma forma mais direta de lidar com esta operação. (Herdado de XmlReader)
ReadElementString(String)	Verifica se a Name propriedade do elemento encontrado corresponde à cadeia dada antes de ler um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString() método, pois oferece uma forma mais direta de lidar com esta operação. (Herdado de XmlReader)
ReadEndElement()	Verifica se o nó de conteúdo atual é uma etiqueta final e avança o leitor para o nó seguinte. (Herdado de XmlReader)
ReadInnerXml()	Quando sobrescrito numa classe derivada, lê todo o conteúdo, incluindo a marcação, como uma cadeia. (Herdado de XmlReader)
ReadInnerXmlAsync()	Lê assíncronamente todo o conteúdo, incluindo a marcação, como uma cadeia. (Herdado de XmlReader)
ReadOuterXml()	Quando sobreposto numa classe derivada, lê o conteúdo, incluindo a marcação, representando este nó e todos os seus filhos. (Herdado de XmlReader)
ReadOuterXmlAsync()	Lê assíncronamente o conteúdo, incluindo a marcação, que representa este nó e todos os seus filhos. (Herdado de XmlReader)
ReadStartElement()	Verifica se o nó atual é um elemento e avança o leitor para o próximo nó. (Herdado de XmlReader)
ReadStartElement(String, String)	Verifica se o nó de conteúdo atual é um elemento com o dado LocalName e NamespaceURI avança o leitor para o nó seguinte. (Herdado de XmlReader)
ReadStartElement(String)	Verifica se o nó de conteúdo atual é um elemento com o dado Name e avança o leitor para o nó seguinte. (Herdado de XmlReader)
ReadString()	Lê o conteúdo de um elemento ou de um nó de texto como uma cadeia de caracteres.
ReadSubtree()	Devolve uma nova XmlReader instância que pode ser usada para ler o nó atual e todos os seus descendentes. (Herdado de XmlReader)
ReadToDescendant(String, String)	Avança para XmlReader o próximo elemento descendente com o nome local especificado e o espaço de nomes URI. (Herdado de XmlReader)
ReadToDescendant(String)	Avança para XmlReader o próximo elemento descendente com o nome qualificado especificado. (Herdado de XmlReader)
ReadToFollowing(String, String)	Lê até que um elemento com o nome local especificado e o URI do namespace seja encontrado. (Herdado de XmlReader)
ReadToFollowing(String)	Lê-se até ser encontrado um elemento com o nome qualificado especificado. (Herdado de XmlReader)
ReadToNextSibling(String, String)	Avança para XmlReader o próximo elemento irmão com o nome local especificado e o espaço de nomes URI. (Herdado de XmlReader)
ReadToNextSibling(String)	Avança XmlReader para o próximo elemento irmão com o nome qualificado especificado. (Herdado de XmlReader)
ReadValueChunk(Char[], Int32, Int32)	Lê grandes fluxos de texto embutidos num documento XML. (Herdado de XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Lê assíncronamente grandes fluxos de texto embutidos num documento XML. (Herdado de XmlReader)
ResetState()	Reinicia o estado do leitor para ReadState.Initial.
ResolveEntity()	Resolve a referência da entidade para EntityReference nós.
Skip()	Ignora os filhos do nó atual.
SkipAsync()	Salta assíncronamente os filhos do nó atual. (Herdado de XmlReader)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Implementações de Interface Explícita

Name	Description
IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Para uma descrição deste elemento, veja GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Para uma descrição deste elemento, veja LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Para uma descrição deste elemento, veja LookupPrefix(String).

Ver também

• Documentos e dados XML