XmlTextReader Classe

Definição

Namespace:: System.Xml

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Em vez disso, recomendamos que você use a XmlReader classe.

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

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

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

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

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

Herança: Object

XmlReader
XmlTextReader

Implementações: IXmlLineInfo IXmlNamespaceResolver

Comentários

Para obter mais informações sobre essa API, consulte comentários da API Suplementar para XmlTextReader.

Notas aos Herdeiros

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

Construtores

Nome	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 XmlNodeTypeespecificado 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 a URL, o fluxo e XmlNameTable.
XmlTextReader(String, Stream)	Inicializa uma nova instância da XmlTextReader classe com a URL e o fluxo especificados.
XmlTextReader(String, TextReader, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com a URL TextReader especificada e XmlNameTable.
XmlTextReader(String, TextReader)	Inicializa uma nova instância da XmlTextReader classe com a URL especificada e TextReader.
XmlTextReader(String, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com o arquivo especificado e XmlNameTable.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Inicializa uma nova instância da XmlTextReader classe com a cadeia de caracteres especificada XmlNodeTypee XmlParserContext.
XmlTextReader(String)	Inicializa uma nova instância da XmlTextReader classe com o arquivo especificado.
XmlTextReader(TextReader, XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com o especificado TextReader e XmlNameTable.
XmlTextReader(TextReader)	Inicializa uma nova instância da XmlTextReader classe com a especificada TextReader.
XmlTextReader(XmlNameTable)	Inicializa uma nova instância da XmlTextReader classe com a especificada XmlNameTable.

Propriedades

Nome	Description
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 conteúdo binário implementa os métodos de leitura de conteúdo binário.
CanReadValueChunk	Obtém um valor que indica se o XmlTextReader método implementa ReadValueChunk(Char[], Int32, Int32) .
CanResolveEntity	Obtém um valor que indica se esse leitor pode analisar e resolver entidades.
CanResolveEntity	Obtém um valor que indica se esse 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 DtdProcessing enumeração.
Encoding	Obtém a codificação do documento.
EntityHandling	Obtém ou define um valor que especifica como o leitor lida com 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 a partir do valor padrão definido no DTD ou no 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 local especificado e o URI do namespace.
Item[String, String]	Quando substituído em uma classe derivada, obtém o valor do atributo com o especificado LocalName e NamespaceURI. (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 especificado Name. (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 o namespace deve ser compatível.
NamespaceURI	Obtém o URI do espaço de nomes (conforme definido na especificação espaço de nomes W3C) do nó no qual o leitor está posicionado.
NameTable	Obtém o XmlNameTable associado a essa implementação.
NodeType	Obtém o tipo de nó atual.
Normalization	Obtém ou define um valor que indica se os valores de espaço em branco e atributo devem ser normalizados.
Prefix	Obtém o prefixo de espaço de nomes associado ao nó atual.
ProhibitDtd	Obsoleto. Obtém ou define um valor que indica se o processamento de DTD deve ser permitido. Esta propriedade é obsoleta. Use DtdProcessing em seu lugar.
QuoteChar	Obtém o caractere de aspas usado para colocar o valor de um nó de atributo.
ReadState	Obtém o estado do leitor.
SchemaInfo	Obtém as informações de esquema atribuídas ao nó atual como resultado da validação do esquema. (Herdado de XmlReader)
Settings	Obtém o XmlReaderSettings objeto usado para criar essa XmlTextReader instância.
Settings	Obtém o XmlReaderSettings objeto usado para criar essa XmlReader instância. (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 atual `xml:lang` .
XmlResolver	Define o XmlResolver usado para resolver referências DTD.
XmlSpace	Obtém o escopo atual `xml:space` .

Métodos

Nome	Description
Close()	Altera o ReadState para `Closed`.
Dispose()	Libera todos os recursos usados pela instância atual da XmlReader classe. (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, String)	Obtém o valor do atributo com o nome local especificado e o URI do namespace.
GetAttribute(String)	Obtém o valor do atributo com o nome especificado.
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetNamespacesInScope(XmlNamespaceScope)	Obtém uma coleção que contém todos os namespaces atualmente no escopo.
GetRemainder()	Obtém o restante do XML em buffer.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValueAsync()	Obtém de forma assíncrona o valor do nó atual. (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 inicial ou uma marca de elemento vazia. (Herdado de XmlReader)
IsStartElement(String, String)	Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca inicial ou uma marca de elemento vazia e se as LocalName propriedades do NamespaceURI elemento encontrado correspondem às cadeias de caracteres fornecidas. (Herdado de XmlReader)
IsStartElement(String)	Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca inicial ou uma marca de elemento vazia e se a Name propriedade do elemento encontrado corresponde ao argumento fornecido. (Herdado de XmlReader)
LookupNamespace(String)	Resolve um prefixo de namespace no escopo do elemento atual.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MoveToAttribute(Int32)	Move para o atributo com o índice especificado.
MoveToAttribute(String, String)	Move para o atributo com o nome local especificado e o URI do namespace.
MoveToAttribute(String)	Move para o atributo com o nome especificado.
MoveToContent()	Verifica se o nó atual é um conteúdo (texto de espaço não branco, `CDATA`, `Element`, , `EndElement`, `EntityReference`ou `EndEntity`) nó. Se o nó não for um nó de conteúdo, o leitor ignorará o próximo nó de conteúdo ou o fim do arquivo. Ele ignora nós do seguinte tipo: `ProcessingInstruction`, , `DocumentType`, `Comment`, ou `WhitespaceSignificantWhitespace`. (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 ignorará o próximo nó de conteúdo ou o fim 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ê de forma assíncrona o próximo nó do fluxo. (Herdado de XmlReader)
ReadAttributeValue()	Analisa o valor do atributo em um ou mais `TextEntityReference`nós ou `EndEntity` nós.
ReadBase64(Byte[], Int32, Int32)	Decodifica 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 foi 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ê o conteúdo de forma assíncrona como um objeto do tipo especificado. (Herdado de XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Lê o conteúdo e retorna os `Base64` bytes binários decodificados.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Lê o conteúdo de forma assíncrona e retorna os bytes binários decodificados em Base64. (Herdado de XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Lê o conteúdo e retorna os `BinHex` bytes binários decodificados.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Lê o conteúdo de forma assíncrona e retorna 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 precisão dupla. (Herdado de XmlReader)
ReadContentAsFloat()	Lê o conteúdo do texto na posição atual como um número de ponto flutuante de precisão única. (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 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 do texto na posição atual como um String objeto. (Herdado de XmlReader)
ReadContentAsStringAsync()	Lê de forma assíncrona 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 namespace correspondem ao do elemento atual e lê o conteúdo do elemento como o tipo solicitado. (Herdado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Lê o conteúdo do elemento 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 base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Lê o elemento de forma assíncrona 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ê o elemento de forma assíncrona e decodifica o `BinHex` conteúdo. (Herdado de XmlReader)
ReadElementContentAsBoolean()	Lê o elemento atual e retorna o conteúdo como um Boolean objeto. (Herdado de XmlReader)
ReadElementContentAsBoolean(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um Boolean objeto. (Herdado de XmlReader)
ReadElementContentAsDateTime()	Lê o elemento atual e retorna o conteúdo como um DateTime objeto. (Herdado de XmlReader)
ReadElementContentAsDateTime(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um DateTime objeto. (Herdado de XmlReader)
ReadElementContentAsDecimal()	Lê o elemento atual e retorna o conteúdo como um Decimal objeto. (Herdado de XmlReader)
ReadElementContentAsDecimal(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um Decimal objeto. (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 especificado e o URI do namespace correspondem ao 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 número de ponto flutuante de precisão única. (Herdado de XmlReader)
ReadElementContentAsFloat(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão única. (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 especificado e o URI do namespace correspondem ao 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 especificado e o URI do namespace correspondem ao 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 o conteúdo como um Object. (Herdado de XmlReader)
ReadElementContentAsObject(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um Object. (Herdado de XmlReader)
ReadElementContentAsObjectAsync()	Lê o elemento atual de forma assíncrona e retorna o conteúdo como um Object. (Herdado de XmlReader)
ReadElementContentAsString()	Lê o elemento atual e retorna o conteúdo como um String objeto. (Herdado de XmlReader)
ReadElementContentAsString(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um String objeto. (Herdado de XmlReader)
ReadElementContentAsStringAsync()	Lê o elemento atual de forma assíncrona e retorna o conteúdo como um String objeto. (Herdado de XmlReader)
ReadElementString()	Lê um elemento somente texto. No entanto, recomendamos que você use o ReadElementContentAsString() método, pois ele fornece uma maneira mais simples de lidar com essa operação. (Herdado de XmlReader)
ReadElementString(String, String)	Verifica se as LocalName propriedades do NamespaceURI elemento encontrado correspondem às cadeias de caracteres fornecidas antes de ler um elemento somente texto. No entanto, recomendamos que você use o ReadElementContentAsString(String, String) método, pois ele fornece uma maneira mais simples de lidar com essa operação. (Herdado de XmlReader)
ReadElementString(String)	Verifica se a Name propriedade do elemento encontrado corresponde à cadeia de caracteres determinada antes de ler um elemento somente texto. No entanto, recomendamos que você use o ReadElementContentAsString() método, pois 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 término 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 marcação, como uma cadeia de caracteres. (Herdado de XmlReader)
ReadInnerXmlAsync()	Lê de forma assíncrona todo o conteúdo, incluindo marcação, como uma cadeia de caracteres. (Herdado de XmlReader)
ReadOuterXml()	Quando substituído em uma classe derivada, lê o conteúdo, incluindo marcação, representando esse nó e todos os seus filhos. (Herdado de XmlReader)
ReadOuterXmlAsync()	Lê o conteúdo de forma assíncrona, incluindo marcação, representando esse 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 determinado LocalName e NamespaceURI 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 determinado Name 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 elemento ou nó de texto como uma cadeia de caracteres. No entanto, recomendamos que você use o ReadElementContentAsString método, pois ele fornece uma maneira mais simples de lidar com essa operação. (Herdado de XmlReader)
ReadSubtree()	Retorna 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 o XmlReader próximo elemento descendente com o nome local e o URI do namespace especificados. (Herdado de XmlReader)
ReadToDescendant(String)	Avança para o XmlReader próximo elemento descendente com o nome qualificado especificado. (Herdado de XmlReader)
ReadToFollowing(String, String)	Lê até que um elemento com o nome local e o URI do namespace especificados seja encontrado. (Herdado de XmlReader)
ReadToFollowing(String)	Lê até que um elemento com o nome qualificado especificado seja encontrado. (Herdado de XmlReader)
ReadToNextSibling(String, String)	Avança para o `XmlReader` próximo elemento irmão com o nome local e o URI do namespace especificados. (Herdado de XmlReader)
ReadToNextSibling(String)	Avança para o `XmlReader` próximo elemento irmão com o nome qualificado especificado. (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 inseridos em um documento XML. (Herdado de XmlReader)
ResetState()	Redefine o estado do leitor para ReadState.Initial.
ResolveEntity()	Resolve a referência de entidade para `EntityReference` nós.
Skip()	Ignora os subordinados do nó atual.
Skip()	Ignora os subordinados do nó atual. (Herdado de XmlReader)
SkipAsync()	Ignora assíncronamente 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

Nome	Description
IDisposable.Dispose()	Para obter uma descrição deste membro, consulte Dispose(). (Herdado de XmlReader)
IXmlLineInfo.HasLineInfo()	Para obter uma descrição deste membro, consulte HasLineInfo().
IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Para obter uma descrição deste membro, consulte GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Para obter uma descrição deste membro, consulte LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Para obter uma descrição deste membro, consulte LookupPrefix(String).

Aplica-se a

Confira também

Documentos e dados XML

Comentários

Esta página foi útil?