Partilhar via


XmlTextReader Classe

Definição

Representa um leitor que fornece acesso rápido não armazenado em cache e somente de encaminhamento aos dados XML.

A partir do .NET Framework 2.0, recomendamos o uso da classe XmlReader.

public ref class XmlTextReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo, System::Xml::IXmlNamespaceResolver
public ref class XmlTextReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo
public class XmlTextReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver
public class XmlTextReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo
type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver
type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver
Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo
Herança
XmlTextReader
Implementações

Comentários

Para obter mais informações sobre essa API, consulte Comentários sobre a API Complementar para XmlTextReader.

Notas aos Herdeiros

Essa classe tem uma demanda de herança. A confiança total é necessária para herdar de XmlTextReader.

Construtores

XmlTextReader()

Inicializa uma nova instância do XmlTextReader.

XmlTextReader(Stream)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado.

XmlTextReader(Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado e XmlNameTable.

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado, XmlNodeType e XmlParserContext.

XmlTextReader(String)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado.

XmlTextReader(String, Stream)

Inicializa uma nova instância da classe XmlTextReader com a URL e o fluxo especificados.

XmlTextReader(String, Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL, o fluxo e XmlNameTable especificados.

XmlTextReader(String, TextReader)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada e TextReader.

XmlTextReader(String, TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada, TextReader e XmlNameTable.

XmlTextReader(String, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado e XmlNameTable.

XmlTextReader(String, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com a cadeia de caracteres especificada, XmlNodeType e XmlParserContext.

XmlTextReader(TextReader)

Inicializa uma nova instância da classe XmlTextReader com o TextReader especificado.

XmlTextReader(TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o TextReader e XmlNameTable especificados.

XmlTextReader(XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o XmlNameTable especificado.

Propriedades

AttributeCount

Obtém o número de atributos no nó atual.

BaseURI

Obtém o URI base do nó atual.

CanReadBinaryContent

Obtém um valor que indica se o XmlTextReader implementa os métodos de leitura de conteúdo binário.

CanReadBinaryContent

Obtém um valor que indica se o XmlReader implementa os métodos de leitura de conteúdo binário.

(Herdado de XmlReader)
CanReadValueChunk

Obtém um valor que indica se o XmlTextReader implementa o método ReadValueChunk(Char[], Int32, Int32).

CanReadValueChunk

Obtém um valor que indica se o XmlReader implementa o método ReadValueChunk(Char[], Int32, Int32).

(Herdado de XmlReader)
CanResolveEntity

Obtém um valor que indica se este leitor pode analisar e resolver entidades.

CanResolveEntity

Obtém um valor que indica se este leitor pode analisar e resolver entidades.

(Herdado de XmlReader)
Depth

Obtém a profundidade do nó atual no documento XML.

DtdProcessing

Obtém ou define a enumeração de DtdProcessing.

Encoding

Obtém a codificação do documento.

EntityHandling

Obtém ou define um valor que especifica como o leitor trata entidades.

EOF

Obtém um valor que indica se o leitor está posicionado no final do fluxo.

HasAttributes

Obtém um valor que indica se o nó atual tem atributos.

(Herdado de XmlReader)
HasValue

Obtém um valor que indica se o nó atual pode ter um Value diferente de String.Empty.

IsDefault

Obtém um valor que indica se o nó atual é um atributo que foi gerado 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]

Obtém o valor do atributo com o índice especificado.

Item[Int32]

Quando substituído em uma classe derivada, obtém o valor do atributo com o índice especificado.

(Herdado de XmlReader)
Item[String, String]

Obtém o valor do atributo com o nome do local e o URI de namespace especificados.

Item[String, String]

Quando substituído em uma classe derivada, obtém o valor do atributo com o LocalName e o NamespaceURI especificados.

(Herdado de XmlReader)
Item[String]

Obtém o valor do atributo com o nome especificado.

Item[String]

Quando substituído em uma classe derivada, obtém o valor do atributo com o Name especificado.

(Herdado de XmlReader)
LineNumber

Obtém o número de linha atual.

LinePosition

Obtém a posição da linha atual.

LocalName

Obtém o nome local do nó atual.

Name

Obtém o nome qualificado do nó atual.

Namespaces

Obtém ou define um valor que indica se deve-se oferecer suporte ao namespace.

NamespaceURI

Obtém o URI de namespace (conforme definido na especificação de Namespace do W3C) do nó no qual o leitor está posicionado.

NameTable

Obtém o XmlNameTable associado à essa implementação.

NodeType

Obtém o tipo do nó atual.

Normalization

Obtém ou define um valor que indica se você deseja normalizar o espaço em branco e os valores de atributos.

Prefix

Obtém o prefixo de namespace associado ao nó atual.

ProhibitDtd
Obsoleto.
Obsoleto.

Obtém ou define um valor que indica se o processamento do DTD deve ser permitido. Esta propriedade está obsoleta. Use DtdProcessing em seu lugar.

QuoteChar

Obtém o caractere de aspas usado para circunscrever o valor de um nó de atributo.

ReadState

Obtém o estado do leitor.

SchemaInfo

Obtém as informações de esquema que foram atribuídas ao nó atual como resultado da validação de esquema.

(Herdado de XmlReader)
Settings

Obtém o objeto XmlReaderSettings usado para criar essa instância XmlTextReader.

Settings

Obtém o objeto XmlReaderSettings usado para criar essa instância XmlReader.

(Herdado de XmlReader)
Value

Obtém o valor de texto do nó atual.

ValueType

Obtém o tipo CLR (Common Language Runtime) para o nó atual.

(Herdado de XmlReader)
WhitespaceHandling

Obtém ou define um valor que especifica como o espaço em branco é tratado.

XmlLang

Obtém o escopo de xml:lang atual.

XmlResolver

Define o XmlResolver usado para resolver referências de DTD.

XmlSpace

Obtém o escopo de xml:space atual.

Métodos

Close()

Altera o ReadState para Closed.

Dispose()

Libera todos os recursos usados pela instância atual da classe XmlReader.

(Herdado de XmlReader)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo XmlReader e opcionalmente libera os recursos gerenciados.

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

Obtém o valor do atributo com o nome especificado.

GetAttribute(String, String)

Obtém o valor do atributo com o nome do local e o URI de namespace especificados.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetNamespacesInScope(XmlNamespaceScope)

Obtém uma coleção que contém todos os namespaces no escopo no momento.

GetRemainder()

Obtém o restante do XML no buffer.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValueAsync()

Obtém o valor do nó atual de forma assíncrona.

(Herdado de XmlReader)
HasLineInfo()

Obtém um valor que indica se a classe pode retornar informações de linha.

IsStartElement()

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazia.

(Herdado de XmlReader)
IsStartElement(String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazio e se a propriedade Name que o elemento encontrou corresponde ao argumento fornecido.

(Herdado de XmlReader)
IsStartElement(String, String)

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazio e, se as propriedades LocalName e NamespaceURI do elemento encontrado correspondem às cadeias de caracteres fornecidas.

(Herdado de XmlReader)
LookupNamespace(String)

Resolve um prefixo de namespace no escopo do elemento atual.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MoveToAttribute(Int32)

Move para o atributo com o índice especificado.

MoveToAttribute(String)

Move para o atributo com o nome especificado.

MoveToAttribute(String, String)

Move para o atributo com o nome local e o URI de namespace especificados.

MoveToContent()

Verifica se o nó atual é um nó de conteúdo (texto sem espaço em branco, CDATA, Element, EndElement, EntityReference ou EndEntity). Se o nó não for um nó de conteúdo, o leitor avançará para o próximo nó de conteúdo ou para o final do arquivo. Pula nós de tipo seguir: ProcessingInstruction, DocumentType, Comment, Whitespace, ou SignificantWhitespace.

(Herdado de XmlReader)
MoveToContentAsync()

Verifica de forma assíncrona se o nó atual é um nó de conteúdo. Se o nó não for um nó de conteúdo, o leitor avançará para o próximo nó de conteúdo ou para o final do arquivo.

(Herdado de XmlReader)
MoveToElement()

Move para o elemento que contém o nó de atributo atual.

MoveToFirstAttribute()

Move para o primeiro atributo.

MoveToNextAttribute()

Move para o próximo atributo.

Read()

Lê o próximo nó do fluxo.

ReadAsync()

Lê assincronamente o próximo nó do fluxo.

(Herdado de XmlReader)
ReadAttributeValue()

Analisa o valor do atributo em um ou mais nós Text, EntityReference ou EndEntity.

ReadBase64(Byte[], Int32, Int32)

Decodifica a Base64 e retorna os bytes binários decodificados.

ReadBinHex(Byte[], Int32, Int32)

Decodifica BinHex e retorna os bytes binários decodificados.

ReadChars(Char[], Int32, Int32)

Lê o conteúdo de texto de um elemento em um buffer de caracteres. Esse método é projetado para ler grandes fluxos de texto inserido chamando-o sucessivamente.

ReadContentAs(Type, IXmlNamespaceResolver)

Lê o conteúdo como um objeto do tipo especificado.

(Herdado de XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)

Lê de forma assíncrona o conteúdo como um objeto do tipo especificado.

(Herdado de XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)

Lê o conteúdo e retorna os bytes binários decodificados Base64.

ReadContentAsBase64(Byte[], Int32, Int32)

Lê o conteúdo e retorna os bytes binários decodificados de Base64.

(Herdado de XmlReader)
ReadContentAsBase64Async(Byte[], Int32, Int32)

Lê de forma assíncrona o conteúdo e retorna que os bytes binários decodificados de Base64.

(Herdado de XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)

Lê o conteúdo e retorna os bytes binários decodificados BinHex.

ReadContentAsBinHex(Byte[], Int32, Int32)

Lê o conteúdo e retorna os bytes binários decodificados BinHex.

(Herdado de XmlReader)
ReadContentAsBinHexAsync(Byte[], Int32, Int32)

Lê de forma assíncrona o conteúdo e retorna os bytes binários decodificados BinHex.

(Herdado de XmlReader)
ReadContentAsBoolean()

Lê o conteúdo de texto na posição atual como um Boolean.

(Herdado de XmlReader)
ReadContentAsDateTime()

Lê o conteúdo de texto na posição atual como um objeto DateTime.

(Herdado de XmlReader)
ReadContentAsDateTimeOffset()

Lê o conteúdo de texto na posição atual como um objeto DateTimeOffset.

(Herdado de XmlReader)
ReadContentAsDecimal()

Lê o conteúdo de texto na posição atual como um objeto Decimal.

(Herdado de XmlReader)
ReadContentAsDouble()

Lê o conteúdo de texto na posição atual como um número de ponto flutuante de precisão dupla.

(Herdado de XmlReader)
ReadContentAsFloat()

Lê o conteúdo de texto na posição atual como um número de ponto flutuante de precisão simples.

(Herdado de XmlReader)
ReadContentAsInt()

Lê o conteúdo de texto na posição atual como um inteiro com sinal de 32 bits.

(Herdado de XmlReader)
ReadContentAsLong()

Lê o conteúdo de texto na posição atual como um inteiro com sinal 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ê de forma assíncrona o conteúdo do texto na posição atual como um Object.

(Herdado de XmlReader)
ReadContentAsString()

Lê o conteúdo de texto na posição atual como um objeto String.

(Herdado de XmlReader)
ReadContentAsStringAsync()

Lê de forma assíncrona o conteúdo do texto na posição atual como um objeto String.

(Herdado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)

Lê o conteúdo do elemento como o tipo solicitado.

(Herdado de XmlReader)
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.

(Herdado de XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)

Lê de forma assíncrona o conteúdo do elemento como o tipo solicitado.

(Herdado de XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)

Lê o elemento e decodifica o conteúdo de Base64.

ReadElementContentAsBase64(Byte[], Int32, Int32)

Lê o elemento e decodifica o conteúdo de Base64.

(Herdado de XmlReader)
ReadElementContentAsBase64Async(Byte[], Int32, Int32)

Lê de forma assíncrona o elemento e decodifica o conteúdo Base64.

(Herdado de XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)

Lê o elemento e decodifica o conteúdo de BinHex.

ReadElementContentAsBinHex(Byte[], Int32, Int32)

Lê o elemento e decodifica o conteúdo de BinHex.

(Herdado de XmlReader)
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)

Lê de forma assíncrona o elemento e decodifica o conteúdo BinHex.

(Herdado de XmlReader)
ReadElementContentAsBoolean()

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

(Herdado de XmlReader)
ReadElementContentAsBoolean(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto Boolean.

(Herdado de XmlReader)
ReadElementContentAsDateTime()

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

(Herdado de XmlReader)
ReadElementContentAsDateTime(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto DateTime.

(Herdado de XmlReader)
ReadElementContentAsDecimal()

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

(Herdado de XmlReader)
ReadElementContentAsDecimal(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto Decimal.

(Herdado de XmlReader)
ReadElementContentAsDouble()

Lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão dupla.

(Herdado de XmlReader)
ReadElementContentAsDouble(String, String)

Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual, lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão dupla.

(Herdado de XmlReader)
ReadElementContentAsFloat()

Lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão simples.

(Herdado de XmlReader)
ReadElementContentAsFloat(String, String)

Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual, lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão simples.

(Herdado de XmlReader)
ReadElementContentAsInt()

Lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 32 bits.

(Herdado de XmlReader)
ReadElementContentAsInt(String, String)

Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual, lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 32 bits.

(Herdado de XmlReader)
ReadElementContentAsLong()

Lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 64 bits.

(Herdado de XmlReader)
ReadElementContentAsLong(String, String)

Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual, lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 64 bits.

(Herdado de XmlReader)
ReadElementContentAsObject()

Lê o elemento atual e retorna os conteúdos como um Object.

(Herdado de XmlReader)
ReadElementContentAsObject(String, String)

Verifica se o nome local e o URI de namespace especificados são iguais aos do elemento atual, lê o elemento atual e retorna o conteúdo como um Object.

(Herdado de XmlReader)
ReadElementContentAsObjectAsync()

Lê de forma assíncrona o elemento atual e retorna o conteúdo como um Object.

(Herdado de XmlReader)
ReadElementContentAsString()

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

(Herdado de XmlReader)
ReadElementContentAsString(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto String.

(Herdado de XmlReader)
ReadElementContentAsStringAsync()

Lê de forma assíncrona o elemento atual e retorna o conteúdo como um objeto String.

(Herdado de XmlReader)
ReadElementString()

Lê um elemento somente texto. No entanto, é recomendável que você use o método ReadElementContentAsString() em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

(Herdado de XmlReader)
ReadElementString(String)

Verifica se a propriedade Name do elemento encontrado corresponde à cadeia de caracteres fornecida antes de ler um elemento somente texto. No entanto, é recomendável que você use o método ReadElementContentAsString() em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

(Herdado de XmlReader)
ReadElementString(String, String)

Verifica se as propriedades LocalName e NamespaceURI do elemento encontrado correspondem às cadeias de caracteres fornecidas antes de ler um elemento somente de texto. No entanto, é recomendável que você use o método ReadElementContentAsString(String, String) em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

(Herdado de XmlReader)
ReadEndElement()

Verifica se o nó de conteúdo atual é uma marca de fim e avança o leitor para o próximo nó.

(Herdado de XmlReader)
ReadInnerXml()

Quando substituído em uma classe derivada, lê todo o conteúdo, incluindo a marcação, como uma cadeia de caracteres.

(Herdado de XmlReader)
ReadInnerXmlAsync()

Lê de forma assíncrona todo o conteúdo, inclusive a marcação, como uma cadeia de caracteres.

(Herdado de XmlReader)
ReadOuterXml()

Quando substituído em uma classe derivada, lê o conteúdo, inclusive a marcação, que representa esse nó e todos os seus filhos.

(Herdado de XmlReader)
ReadOuterXmlAsync()

Lê de forma assíncrona o conteúdo, inclusive a marcação, representando 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)

Verifica se o nó de conteúdo atual é um elemento com o Name fornecido 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 LocalName e NamespaceURI fornecidos e avança o leitor para o próximo nó.

(Herdado de XmlReader)
ReadString()

Lê o conteúdo de um elemento ou um nó de texto como uma cadeia de caracteres.

ReadString()

Quando substituído em uma classe derivada, lê o conteúdo de um nó de elemento ou texto como uma cadeia de caracteres. No entanto, é recomendável que você use o método ReadElementContentAsString em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

(Herdado de XmlReader)
ReadSubtree()

Retorna uma nova instância XmlReader que pode ser usada para ler o nó atual e todos os seus descendentes.

(Herdado de XmlReader)
ReadToDescendant(String)

Avança o XmlReader para o próximo elemento descendente com o nome qualificado especificado.

(Herdado de XmlReader)
ReadToDescendant(String, String)

Avança o XmlReader para o próximo elemento descendente com o nome local e URI do namespace especificados.

(Herdado de XmlReader)
ReadToFollowing(String)

Lê até que seja encontrado um elemento com o nome qualificado especificado.

(Herdado de XmlReader)
ReadToFollowing(String, String)

Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados.

(Herdado de XmlReader)
ReadToNextSibling(String)

Avança o XmlReader para o próximo elemento irmão com o nome qualificado especificado.

(Herdado de XmlReader)
ReadToNextSibling(String, String)

Avança o XmlReader para o próximo elemento irmão com o nome local e o URI de namespace especificados.

(Herdado de XmlReader)
ReadValueChunk(Char[], Int32, Int32)

Lê grandes fluxos de texto inseridos em um documento XML.

(Herdado de XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)

Lê de forma assíncrona grandes fluxos de texto inserido em um documento XML.

(Herdado de XmlReader)
ResetState()

Redefine o estado do leitor para ReadState.Initial.

ResolveEntity()

Resolve a referência de entidade para nós EntityReference.

Skip()

Ignora os filhos do nó atual.

Skip()

Ignora os filhos do nó atual.

(Herdado de XmlReader)
SkipAsync()

Ignora de forma assíncrona os filhos do nó atual.

(Herdado de XmlReader)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()

Para obter uma descrição desse membro, confira Dispose().

(Herdado de XmlReader)
IXmlLineInfo.HasLineInfo()

Para obter uma descrição desse membro, confira HasLineInfo().

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)

Para obter uma descrição desse membro, confira GetNamespacesInScope(XmlNamespaceScope).

IXmlNamespaceResolver.LookupNamespace(String)

Para obter uma descrição desse membro, confira LookupNamespace(String).

IXmlNamespaceResolver.LookupPrefix(String)

Para obter uma descrição desse membro, confira LookupPrefix(String).

Aplica-se a

Confira também