XmlTextReader Classe

Definição

Representa um leitor que fornece acesso rápido não armazenado em cache e somente de encaminhamento aos dados XML.Represents a reader that provides fast, non-cached, forward-only access to XML data.

A partir do .NET Framework 2.0, recomendamos o uso da classe XmlReader.Starting with the .NET Framework 2.0, we recommend that you use the XmlReader class instead.

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
XmlTextReader
Implementações

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

XmlTextReader fornece acesso somente de encaminhamento e somente leitura a um fluxo de dados XML.XmlTextReader provides forward-only, read-only access to a stream of XML data. O nó atual refere-se ao nó em que o leitor está localizado.The current node refers to the node on which the reader is positioned. O leitor é avançado usando qualquer um dos métodos de leitura e propriedades que refletem o valor do nó atual.The reader is advanced using any of the read methods and properties reflect the value of the current node.

Essa classe implementa XmlReader e está em conformidade com o W3C linguagem XML (XML) 1,0 e os namespaces em recomendações XML.This class implements XmlReader and conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations. XmlTextReader fornece a seguinte funcionalidade:XmlTextReader provides the following functionality:

  • Impõe as regras de XML bem formado.Enforces the rules of well-formed XML.

  • XmlTextReader não fornece validação de dados.XmlTextReader does not provide data validation.

  • Verifica se os nós DocumentType estão bem formados.Checks that DocumentType nodes are well-formed. XmlTextReader verifica o DTD para uma boa formação, mas não valida usando o DTD.XmlTextReader checks the DTD for well-formedness, but does not validate using the DTD.

  • Para nós em que NodeType é XmlNodeType.EntityReference, um único nó EntityReference vazio é retornado (ou seja, a propriedade Value é String.Empty).For nodes where NodeType is XmlNodeType.EntityReference, a single empty EntityReference node is returned (that is, the Value property is String.Empty).

Observação

As declarações reais de entidades no DTD são chamadas de nós Entity.The actual declarations of entities in the DTD are called Entity nodes. Quando você faz referência a esses nós em seus dados, eles são chamados de nós EntityReference.When you refer to these nodes in your data, they are called EntityReference nodes.

  • Não expande atributos padrão.Does not expand default attributes.

Como o XmlTextReader não executa as verificações adicionais necessárias para a validação de dados, ele fornece um analisador de boa formação rápida.Because the XmlTextReader does not perform the extra checks required for data validation, it provides a fast well-formedness parser.

Para executar a validação de dados, use um XmlReader de validação.To perform data validation, use a validating XmlReader.

Para ler dados XML de um XmlDocument, use XmlNodeReader.To read XML data from an XmlDocument, use XmlNodeReader.

XmlTextReader gera um XmlException em erros de análise de XML.XmlTextReader throws an XmlException on XML parse errors. Depois que uma exceção é lançada, o estado do leitor não é previsível.After an exception is thrown the state of the reader is not predictable. Por exemplo, o tipo de nó relatado pode ser diferente do tipo de nó real do nó atual.For example, the reported node type may be different than the actual node type of the current node. Use a propriedade ReadState para verificar se um leitor está em estado de erro.Use the ReadState property to check whether a reader is in error state.

Considerações sobre segurançaSecurity Considerations

Veja a seguir as coisas a serem consideradas ao usar a classe XmlTextReader.The following are things to consider when using the XmlTextReader class.

  • Exceções lançadas o XmlTextReader pode divulgar informações de caminho que você não deseja que sejam compagadas ao aplicativo.Exceptions thrown the XmlTextReader can disclose path information that you do not want bubbled up to the application. Os aplicativos devem capturar exceções e processar-las apropriadamente.Your applications must catch exceptions and process them appropriately.

  • O processamento de DTD é ativado por padrão.DTD processing is enabled by default. Desabilite o processamento de DTD se estiver preocupado com problemas de negação de serviço ou se estiver lidando com fontes não confiáveis.Disable DTD processing if you are concerned about Denial of Service issues or if you are dealing with untrusted sources. Defina a propriedade DtdProcessing como Prohibit para desabilitar o processamento de DTD.Set the DtdProcessing property to Prohibit to disable DTD processing.

    Se você tiver o processamento de DTD ativado, você pode usar XmlSecureResolver para restringir os recursos que XmlTextReader pode acessar.If you have DTD processing enabled, you can use the XmlSecureResolver to restrict the resources that the XmlTextReader can access. Você também pode criar seu aplicativo para que processar XML é memória e hora restritos.You can also design your application so that the XML processing is memory and time constrained. Por exemplo, configurar limites de tempo limite no seu aplicativo ASP.NET.For example, configure time-out limits in your ASP.NET application.

  • Os dados XML podem incluir referências a recursos externos, como um arquivo DTD.XML data can include references to external resources such as a DTD file. Os recursos externos são determinados por padrão usando um objeto de XmlUrlResolver sem credenciais do usuário.By default external resources are resolved using an XmlUrlResolver object with no user credentials. Você pode proteger este adicional seguindo um destes procedimentos:You can secure this further by doing one of the following:

  • Os dados XML podem conter um grande número de declarações de atributos, namespace, elementos aninhados e assim por diante que exigem um montante considerável de tempo de processamento.XML data can contain a large number of attributes, namespace declarations, nested elements and so on that require a substantial amount of time to process. Para limitar o tamanho da entrada que é enviada para o XmlTextReader, crie uma implementação de IStream personalizada e forneça a XmlTextReader.To limit the size of the input that is sent to the XmlTextReader, create a custom IStream implementation and supply it the XmlTextReader.

  • O método ReadValueChunk pode ser usado para lidar com grandes fluxos de dados.The ReadValueChunk method can be used to handle large streams of data. Este método lê um pequeno número de caracteres de cada vez em vez de atribuir uma única cadeia de caracteres para o valor inteiro.This method reads a small number of characters at a time instead of allocating a single string for the whole value.

  • As entidades gerais não são expandidos por padrão.By default general entities are not expanded. As entidades gerais são expandidas quando você chama o método de ResolveEntity .General entities are expanded when you call the ResolveEntity method.

Notas aos Herdeiros

Essa classe tem uma demanda de herança.This class has an inheritance demand. A confiança total é necessária para herdar de XmlTextReader.Full trust is required to inherit from XmlTextReader.

Construtores

XmlTextReader()

Inicializa uma nova instância do XmlTextReader.Initializes a new instance of the XmlTextReader.

XmlTextReader(Stream)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado.Initializes a new instance of the XmlTextReader class with the specified stream.

XmlTextReader(Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified stream and XmlNameTable.

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado, XmlNodeType e XmlParserContext.Initializes a new instance of the XmlTextReader class with the specified stream, XmlNodeType, and XmlParserContext.

XmlTextReader(String)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado.Initializes a new instance of the XmlTextReader class with the specified file.

XmlTextReader(String, Stream)

Inicializa uma nova instância da classe XmlTextReader com a URL e o fluxo especificados.Initializes a new instance of the XmlTextReader class with the specified URL and stream.

XmlTextReader(String, Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL, o fluxo e XmlNameTable especificados.Initializes a new instance of the XmlTextReader class with the specified URL, stream and XmlNameTable.

XmlTextReader(String, TextReader)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada e TextReader.Initializes a new instance of the XmlTextReader class with the specified URL and TextReader.

XmlTextReader(String, TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada, TextReader e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified URL, TextReader and XmlNameTable.

XmlTextReader(String, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified file and XmlNameTable.

XmlTextReader(String, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com a cadeia de caracteres especificada, XmlNodeType e XmlParserContext.Initializes a new instance of the XmlTextReader class with the specified string, XmlNodeType, and XmlParserContext.

XmlTextReader(TextReader)

Inicializa uma nova instância da classe XmlTextReader com o TextReader especificado.Initializes a new instance of the XmlTextReader class with the specified TextReader.

XmlTextReader(TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o TextReader e XmlNameTable especificados.Initializes a new instance of the XmlTextReader class with the specified TextReader and XmlNameTable.

XmlTextReader(XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o XmlNameTable especificado.Initializes a new instance of the XmlTextReader class with the specified XmlNameTable.

Propriedades

AttributeCount

Obtém o número de atributos no nó atual.Gets the number of attributes on the current node.

BaseURI

Obtém o URI base do nó atual.Gets the base URI of the current node.

CanReadBinaryContent

Obtém um valor que indica se o XmlTextReader implementa os métodos de leitura de conteúdo binário.Gets a value indicating whether the XmlTextReader implements the binary content read methods.

CanReadValueChunk

Obtém um valor que indica se o XmlTextReader implementa o método ReadValueChunk(Char[], Int32, Int32).Gets a value indicating whether the XmlTextReader implements the ReadValueChunk(Char[], Int32, Int32) method.

CanResolveEntity

Obtém um valor que indica se este leitor pode analisar e resolver entidades.Gets a value indicating whether this reader can parse and resolve entities.

Depth

Obtém a profundidade do nó atual no documento XML.Gets the depth of the current node in the XML document.

DtdProcessing

Obtém ou define a enumeração de DtdProcessing.Gets or sets the DtdProcessing enumeration.

Encoding

Obtém a codificação do documento.Gets the encoding of the document.

EntityHandling

Obtém ou define um valor que especifica como o leitor trata entidades.Gets or sets a value that specifies how the reader handles entities.

EOF

Obtém um valor que indica se o leitor está posicionado no final do fluxo.Gets a value indicating whether the reader is positioned at the end of the stream.

HasAttributes

Obtém um valor que indica se o nó atual tem atributos.Gets a value indicating whether the current node has any attributes.

(Herdado de XmlReader)
HasValue

Obtém um valor que indica se o nó atual pode ter um Value diferente de String.Empty.Gets a value indicating whether the current node can have a Value other than 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.Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema.

IsEmptyElement

Obtém um valor que indica se o nó atual é um elemento vazio (por exemplo, <MyElement/>).Gets a value indicating whether the current node is an empty element (for example, <MyElement/>).

Item[Int32]

Obtém o valor do atributo com o índice especificado.Gets the value of the attribute with the specified index.

Item[String, String]

Obtém o valor do atributo com o nome do local e o URI de namespace especificados.Gets the value of the attribute with the specified local name and namespace URI.

Item[String]

Obtém o valor do atributo com o nome especificado.Gets the value of the attribute with the specified name.

LineNumber

Obtém o número de linha atual.Gets the current line number.

LinePosition

Obtém a posição da linha atual.Gets the current line position.

LocalName

Obtém o nome local do nó atual.Gets the local name of the current node.

Name

Obtém o nome qualificado do nó atual.Gets the qualified name of the current node.

Namespaces

Obtém ou define um valor que indica se deve-se oferecer suporte ao namespace.Gets or sets a value indicating whether to do namespace support.

NamespaceURI

Obtém o URI de namespace (conforme definido na especificação de Namespace do W3C) do nó no qual o leitor está posicionado.Gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned.

NameTable

Obtém o XmlNameTable associado à essa implementação.Gets the XmlNameTable associated with this implementation.

NodeType

Obtém o tipo do nó atual.Gets the type of the current node.

Normalization

Obtém ou define um valor que indica se você deseja normalizar o espaço em branco e os valores de atributos.Gets or sets a value indicating whether to normalize white space and attribute values.

Prefix

Obtém o prefixo de namespace associado ao nó atual.Gets the namespace prefix associated with the current node.

ProhibitDtd

Obtém ou define um valor que indica se o processamento do DTD deve ser permitido.Gets or sets a value indicating whether to allow DTD processing. Esta propriedade está obsoleta.This property is obsolete. Use DtdProcessing em seu lugar.Use DtdProcessing instead.

QuoteChar

Obtém o caractere de aspas usado para circunscrever o valor de um nó de atributo.Gets the quotation mark character used to enclose the value of an attribute node.

ReadState

Obtém o estado do leitor.Gets the state of the reader.

SchemaInfo

Obtém as informações de esquema que foram atribuídas ao nó atual como resultado da validação de esquema.Gets the schema information that has been assigned to the current node as a result of schema validation.

(Herdado de XmlReader)
Settings

Obtém o objeto XmlReaderSettings usado para criar essa instância XmlTextReader.Gets the XmlReaderSettings object used to create this XmlTextReader instance.

Value

Obtém o valor de texto do nó atual.Gets the text value of the current node.

ValueType

Obtém o tipo CLR (Common Language Runtime) para o nó atual.Gets The Common Language Runtime (CLR) type for the current node.

(Herdado de XmlReader)
WhitespaceHandling

Obtém ou define um valor que especifica como o espaço em branco é tratado.Gets or sets a value that specifies how white space is handled.

XmlLang

Obtém o escopo de xml:lang atual.Gets the current xml:lang scope.

XmlResolver

Define o XmlResolver usado para resolver referências de DTD.Sets the XmlResolver used for resolving DTD references.

XmlSpace

Obtém o escopo de xml:space atual.Gets the current xml:space scope.

Métodos

Close()

Altera o ReadState para Closed.Changes the ReadState to Closed.

Dispose()

Libera todos os recursos usados pela instância atual da classe XmlReader.Releases all resources used by the current instance of the XmlReader class.

(Herdado de XmlReader)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo XmlReader e, opcionalmente, libera os recursos gerenciados.Releases the unmanaged resources used by the XmlReader and optionally releases the managed resources.

(Herdado de XmlReader)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetAttribute(Int32)

Obtém o valor do atributo com o índice especificado.Gets the value of the attribute with the specified index.

GetAttribute(String)

Obtém o valor do atributo com o nome especificado.Gets the value of the attribute with the specified name.

GetAttribute(String, String)

Obtém o valor do atributo com o nome do local e o URI de namespace especificados.Gets the value of the attribute with the specified local name and namespace URI.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetNamespacesInScope(XmlNamespaceScope)

Obtém uma coleção que contém todos os namespaces no escopo no momento.Gets a collection that contains all namespaces currently in-scope.

GetRemainder()

Obtém o restante do XML no buffer.Gets the remainder of the buffered XML.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValueAsync()

Obtém o valor do nó atual de forma assíncrona.Asynchronously gets the value of the current node.

(Herdado de XmlReader)
HasLineInfo()

Obtém um valor que indica se a classe pode retornar informações de linha.Gets a value indicating whether the class can return line information.

IsStartElement()

Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazia.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

(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.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the Name property of the element found matches the given argument.

(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.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the LocalName and NamespaceURI properties of the element found match the given strings.

(Herdado de XmlReader)
LookupNamespace(String)

Resolve um prefixo de namespace no escopo do elemento atual.Resolves a namespace prefix in the current element's scope.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MoveToAttribute(Int32)

Move para o atributo com o índice especificado.Moves to the attribute with the specified index.

MoveToAttribute(String)

Move para o atributo com o nome especificado.Moves to the attribute with the specified name.

MoveToAttribute(String, String)

Move para o atributo com o nome local e o URI de namespace especificados.Moves to the attribute with the specified local name and namespace URI.

MoveToContent()

Verifica se o nó atual é um nó de conteúdo (texto sem espaço em branco, CDATA, Element, EndElement, EntityReference ou EndEntity).Checks whether the current node is a content (non-white space text, CDATA, Element, EndElement, EntityReference, or EndEntity) node. 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.If the node is not a content node, the reader skips ahead to the next content node or end of file. Pula nós de tipo seguir: ProcessingInstruction, DocumentType, Comment, Whitespace, ou SignificantWhitespace.It skips over nodes of the following type: ProcessingInstruction, DocumentType, Comment, Whitespace, or SignificantWhitespace.

(Herdado de XmlReader)
MoveToContentAsync()

Verifica de forma assíncrona se o nó atual é um nó de conteúdo.Asynchronously checks whether the current node is a content node. 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.If the node is not a content node, the reader skips ahead to the next content node or end of file.

(Herdado de XmlReader)
MoveToElement()

Move para o elemento que contém o nó de atributo atual.Moves to the element that contains the current attribute node.

MoveToFirstAttribute()

Move para o primeiro atributo.Moves to the first attribute.

MoveToNextAttribute()

Move para o próximo atributo.Moves to the next attribute.

Read()

Lê o próximo nó do fluxo.Reads the next node from the stream.

ReadAsync()

Lê assincronamente o próximo nó do fluxo.Asynchronously reads the next node from the stream.

(Herdado de XmlReader)
ReadAttributeValue()

Analisa o valor do atributo em um ou mais nós Text, EntityReferenceou EndEntity .Parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.

ReadBase64(Byte[], Int32, Int32)

Decodifica a Base64 e retorna os bytes binários decodificados.Decodes Base64 and returns the decoded binary bytes.

ReadBinHex(Byte[], Int32, Int32)

Decodifica BinHex e retorna os bytes binários decodificados.Decodes BinHex and returns the decoded binary bytes.

ReadChars(Char[], Int32, Int32)

Lê o conteúdo de texto de um elemento em um buffer de caracteres.Reads the text contents of an element into a character buffer. Esse método é projetado para ler grandes fluxos de texto inserido chamando-o sucessivamente.This method is designed to read large streams of embedded text by calling it successively.

ReadContentAs(Type, IXmlNamespaceResolver)

Lê o conteúdo como um objeto do tipo especificado.Reads the content as an object of the type specified.

(Herdado de XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)

Lê de forma assíncrona o conteúdo como um objeto do tipo especificado.Asynchronously reads the content as an object of the type specified.

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

Lê o conteúdo e retorna os bytes binários decodificados Base64.Reads the content and returns the Base64 decoded binary bytes.

ReadContentAsBase64Async(Byte[], Int32, Int32)

Lê de forma assíncrona o conteúdo e retorna que os bytes binários decodificados de Base64.Asynchronously reads the content and returns the Base64 decoded binary bytes.

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

Lê o conteúdo e retorna os bytes binários decodificados BinHex.Reads the content and returns the BinHex decoded binary bytes.

ReadContentAsBinHexAsync(Byte[], Int32, Int32)

Lê de forma assíncrona o conteúdo e retorna os bytes binários decodificados BinHex.Asynchronously reads the content and returns the BinHex decoded binary bytes.

(Herdado de XmlReader)
ReadContentAsBoolean()

Lê o conteúdo de texto na posição atual como um Boolean.Reads the text content at the current position as a Boolean.

(Herdado de XmlReader)
ReadContentAsDateTime()

Lê o conteúdo de texto na posição atual como um objeto DateTime.Reads the text content at the current position as a DateTime object.

(Herdado de XmlReader)
ReadContentAsDateTimeOffset()

Lê o conteúdo de texto na posição atual como um objeto DateTimeOffset.Reads the text content at the current position as a DateTimeOffset object.

(Herdado de XmlReader)
ReadContentAsDecimal()

Lê o conteúdo de texto na posição atual como um objeto Decimal.Reads the text content at the current position as a Decimal object.

(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.Reads the text content at the current position as a double-precision floating-point number.

(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.Reads the text content at the current position as a single-precision floating point number.

(Herdado de XmlReader)
ReadContentAsInt()

Lê o conteúdo de texto na posição atual como um inteiro com sinal de 32 bits.Reads the text content at the current position as a 32-bit signed integer.

(Herdado de XmlReader)
ReadContentAsLong()

Lê o conteúdo de texto na posição atual como um inteiro com sinal de 64 bits.Reads the text content at the current position as a 64-bit signed integer.

(Herdado de XmlReader)
ReadContentAsObject()

Lê o conteúdo do texto na posição atual como um Object.Reads the text content at the current position as an Object.

(Herdado de XmlReader)
ReadContentAsObjectAsync()

Lê de forma assíncrona o conteúdo do texto na posição atual como um Object.Asynchronously reads the text content at the current position as an Object.

(Herdado de XmlReader)
ReadContentAsString()

Lê o conteúdo de texto na posição atual como um objeto String.Reads the text content at the current position as a String object.

(Herdado de XmlReader)
ReadContentAsStringAsync()

Lê de forma assíncrona o conteúdo do texto na posição atual como um objeto String.Asynchronously reads the text content at the current position as a String object.

(Herdado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)

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

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

(Herdado de XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)

Lê de forma assíncrona o conteúdo do elemento como o tipo solicitado.Asynchronously reads the element content as the requested type.

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

Lê o elemento e decodifica o conteúdo de Base64.Reads the element and decodes the Base64 content.

ReadElementContentAsBase64Async(Byte[], Int32, Int32)

Lê de forma assíncrona o elemento e decodifica o conteúdo Base64.Asynchronously reads the element and decodes the Base64 content.

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

Lê o elemento e decodifica o conteúdo de BinHex.Reads the element and decodes the BinHex content.

ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)

Lê de forma assíncrona o elemento e decodifica o conteúdo BinHex.Asynchronously reads the element and decodes the BinHex content.

(Herdado de XmlReader)
ReadElementContentAsBoolean()

Lê o elemento atual e retorna o conteúdo como um objeto Boolean.Reads the current element and returns the contents as a Boolean object.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a Boolean object.

(Herdado de XmlReader)
ReadElementContentAsDateTime()

Lê o elemento atual e retorna o conteúdo como um objeto DateTime.Reads the current element and returns the contents as a DateTime object.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a DateTime object.

(Herdado de XmlReader)
ReadElementContentAsDecimal()

Lê o elemento atual e retorna o conteúdo como um objeto Decimal.Reads the current element and returns the contents as a Decimal object.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a Decimal object.

(Herdado de XmlReader)
ReadElementContentAsDouble()

Lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão dupla.Reads the current element and returns the contents as a double-precision floating-point number.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a double-precision floating-point number.

(Herdado de XmlReader)
ReadElementContentAsFloat()

Lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão simples.Reads the current element and returns the contents as single-precision floating-point number.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a single-precision floating-point number.

(Herdado de XmlReader)
ReadElementContentAsInt()

Lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 32 bits.Reads the current element and returns the contents as a 32-bit signed integer.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 32-bit signed integer.

(Herdado de XmlReader)
ReadElementContentAsLong()

Lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 64 bits.Reads the current element and returns the contents as a 64-bit signed integer.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 64-bit signed integer.

(Herdado de XmlReader)
ReadElementContentAsObject()

Lê o elemento atual e retorna os conteúdos como um Object.Reads the current element and returns the contents as an 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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as an Object.

(Herdado de XmlReader)
ReadElementContentAsObjectAsync()

Lê de forma assíncrona o elemento atual e retorna o conteúdo como um Object.Asynchronously reads the current element and returns the contents as an Object.

(Herdado de XmlReader)
ReadElementContentAsString()

Lê o elemento atual e retorna o conteúdo como um objeto String.Reads the current element and returns the contents as a String object.

(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.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

(Herdado de XmlReader)
ReadElementContentAsStringAsync()

Lê de forma assíncrona o elemento atual e retorna o conteúdo como um objeto String.Asynchronously reads the current element and returns the contents as a String object.

(Herdado de XmlReader)
ReadElementString()

Lê um elemento somente texto.Reads a text-only element. 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.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

(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.Checks that the Name property of the element found matches the given string before reading a text-only element. 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.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

(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.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. 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.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

(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ó.Checks that the current content node is an end tag and advances the reader to the next node.

(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.When overridden in a derived class, reads all the content, including markup, as a string.

(Herdado de XmlReader)
ReadInnerXmlAsync()

Lê de forma assíncrona todo o conteúdo, inclusive a marcação, como uma cadeia de caracteres.Asynchronously reads all the content, including markup, as a string.

(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.When overridden in a derived class, reads the content, including markup, representing this node and all its children.

(Herdado de XmlReader)
ReadOuterXmlAsync()

Lê de forma assíncrona o conteúdo, inclusive a marcação, representando este nó e todos os seus filhos.Asynchronously reads the content, including markup, representing this node and all its children.

(Herdado de XmlReader)
ReadStartElement()

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.Checks that the current node is an element and advances the reader to the next node.

(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ó.Checks that the current content node is an element with the given Name and advances the reader to the next node.

(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ó.Checks that the current content node is an element with the given LocalName and NamespaceURI and advances the reader to the next node.

(Herdado de XmlReader)
ReadString()

Lê o conteúdo de um elemento ou um nó de texto como uma cadeia de caracteres.Reads the contents of an element or a text node as a string.

ReadSubtree()

Retorna uma nova instância XmlReader que pode ser usada para ler o nó atual e todos os seus descendentes.Returns a new XmlReader instance that can be used to read the current node, and all its descendants.

(Herdado de XmlReader)
ReadToDescendant(String)

Avança o XmlReader para o próximo elemento descendente com o nome qualificado especificado.Advances the XmlReader to the next descendant element with the specified qualified name.

(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.Advances the XmlReader to the next descendant element with the specified local name and namespace URI.

(Herdado de XmlReader)
ReadToFollowing(String)

Lê até que seja encontrado um elemento com o nome qualificado especificado.Reads until an element with the specified qualified name is found.

(Herdado de XmlReader)
ReadToFollowing(String, String)

Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados.Reads until an element with the specified local name and namespace URI is found.

(Herdado de XmlReader)
ReadToNextSibling(String)

Avança o XmlReader para o próximo elemento irmão com o nome qualificado especificado.Advances the XmlReader to the next sibling element with the specified qualified name.

(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.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

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

Lê grandes fluxos de texto inseridos em um documento XML.Reads large streams of text embedded in an XML document.

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

Lê de forma assíncrona grandes fluxos de texto inserido em um documento XML.Asynchronously reads large streams of text embedded in an XML document.

(Herdado de XmlReader)
ResetState()

Redefine o estado do leitor para ReadState.Initial.Resets the state of the reader to ReadState.Initial.

ResolveEntity()

Resolve a referência de entidade para nós EntityReference.Resolves the entity reference for EntityReference nodes.

Skip()

Ignora os filhos do nó atual.Skips the children of the current node.

SkipAsync()

Ignora de forma assíncrona os filhos do nó atual.Asynchronously skips the children of the current node.

(Herdado de XmlReader)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()

Para obter uma descrição desse membro, consulte Dispose().For a description of this member, see Dispose().

(Herdado de XmlReader)
IXmlLineInfo.HasLineInfo()

Para obter uma descrição desse membro, consulte HasLineInfo().For a description of this member, see HasLineInfo().

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)

Para obter uma descrição desse membro, consulte GetNamespacesInScope(XmlNamespaceScope).For a description of this member, see GetNamespacesInScope(XmlNamespaceScope).

IXmlNamespaceResolver.LookupNamespace(String)

Para obter uma descrição desse membro, consulte LookupNamespace(String).For a description of this member, see LookupNamespace(String).

IXmlNamespaceResolver.LookupPrefix(String)

Para obter uma descrição desse membro, consulte LookupPrefix(String).For a description of this member, see LookupPrefix(String).

Aplica-se a

Veja também