XmlReader Classe
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 de encaminhamento aos dados XML.
public ref class XmlReader abstract : IDisposable
public ref class XmlReader abstract
public abstract class XmlReader : IDisposable
public abstract class XmlReader
type XmlReader = class
interface IDisposable
type XmlReader = class
Public MustInherit Class XmlReader
Implements IDisposable
Public MustInherit Class XmlReader
- Herança
-
XmlReader
- Derivado
- Implementações
O código de exemplo a seguir mostra como usar a API assíncrona para analisar XML.
async Task TestReader(System.IO.Stream stream)
{
XmlReaderSettings settings = new XmlReaderSettings();
settings.Async = true;
using (XmlReader reader = XmlReader.Create(stream, settings))
{
while (await reader.ReadAsync())
{
switch (reader.NodeType)
{
case XmlNodeType.Element:
Console.WriteLine("Start Element {0}", reader.Name);
break;
case XmlNodeType.Text:
Console.WriteLine("Text Node: {0}",
await reader.GetValueAsync());
break;
case XmlNodeType.EndElement:
Console.WriteLine("End Element {0}", reader.Name);
break;
default:
Console.WriteLine("Other node {0} with value {1}",
reader.NodeType, reader.Value);
break;
}
}
}
}
Public Async Function TestReader(stream As System.IO.Stream) As Task
Dim settings As New XmlReaderSettings()
settings.Async = True
Using reader As XmlReader = XmlReader.Create(stream, settings)
While (Await reader.ReadAsync())
Select Case (reader.NodeType)
Case XmlNodeType.Element
Console.WriteLine("Start Element {0}", reader.Name)
Case XmlNodeType.Text
Console.WriteLine("Text Node: {0}",
Await reader.GetValueAsync())
Case XmlNodeType.EndElement
Console.WriteLine("End Element {0}", reader.Name)
Case Else
Console.WriteLine("Other node {0} with value {1}",
reader.NodeType, reader.Value)
End Select
End While
End Using
End Function
Para obter mais informações sobre essa API, consulte Comentários sobre a API Complementar para XmlReader.
Xml |
Inicializa uma nova instância da classe |
Attribute |
Quando substituído em uma classe derivada, obtém o número de atributos no nó atual. |
BaseURI |
Quando substituído em uma classe derivada, obtém o URI base do nó atual. |
Can |
Obtém um valor que indica se o XmlReader implementa os métodos de leitura de conteúdo binário. |
Can |
Obtém um valor que indica se o XmlReader implementa o método ReadValueChunk(Char[], Int32, Int32). |
Can |
Obtém um valor que indica se este leitor pode analisar e resolver entidades. |
Depth |
Quando é substituído em uma classe derivada, obtém a profundidade do nó atual no documento XML. |
EOF |
Quando substituído em uma classe derivada, obtém um valor que indica se o leitor está posicionado no final do fluxo. |
Has |
Obtém um valor que indica se o nó atual tem atributos. |
Has |
Quando substituído em uma classe derivada, obtém um valor que indica se o nó atual pode ter um Value. |
Is |
Quando substituído em uma classe derivada, obtém um valor que indica se o nó atual é um atributo que foi gerado com base no valor padrão definido no DTD ou no esquema. |
Is |
Quando substituído em uma classe derivada, obtém um valor que indica se o nó atual é um elemento vazio (por exemplo, |
Item[Int32] |
Quando substituído em uma classe derivada, obtém o valor do atributo com o índice especificado. |
Item[String, String] |
Quando substituído em uma classe derivada, obtém o valor do atributo com o LocalName e o NamespaceURI especificados. |
Item[String] |
Quando substituído em uma classe derivada, obtém o valor do atributo com o Name especificado. |
Local |
Quando é substituído em uma classe derivada, obtém o nome local do nó atual. |
Name |
Quando é substituído em uma classe derivada, obtém o nome qualificado do nó atual. |
NamespaceURI |
Quando substituído em uma classe derivada, obtém o URI do namespace (conforme definido na especificação de Namespace do W3C) do nó no qual o leitor está posicionado. |
Name |
Quando substituído em uma classe derivada, obtém o XmlNameTable associado a essa implementação. |
Node |
Quando é substituído em uma classe derivada, obtém o tipo do nó atual. |
Prefix |
Quando substituído em uma classe derivada, obtém o prefixo de namespace associado com o nó atual. |
Quote |
Quando substituído em uma classe derivada, obtém o caractere de aspas usado para circunscrever o valor de um nó de atributo. |
Read |
Quando substituído em uma classe derivada, obtém o estado do leitor. |
Schema |
Obtém as informações de esquema que foram atribuídas ao nó atual como resultado da validação de esquema. |
Settings |
Obtém o objeto XmlReaderSettings usado para criar essa instância XmlReader. |
Value |
Quando é substituído em uma classe derivada, obtém o valor do texto do nó atual. |
Value |
Obtém o tipo CLR (Common Language Runtime) para o nó atual. |
Xml |
Quando substituído em uma classe derivada, obtém o escopo |
Xml |
Quando substituído em uma classe derivada, obtém o escopo |
Close() |
Quando substituído em uma classe derivada, altera o ReadState para Closed. |
Create(Stream) |
Cria uma nova instância XmlReader usando o fluxo especificado com as configurações padrão. |
Create(Stream, Xml |
Cria uma nova instância XmlReader com as configurações e o fluxo especificado. |
Create(Stream, Xml |
Cria uma nova instância XmlReader usando o fluxo, o URI base e as configurações especificadas. |
Create(Stream, Xml |
Cria uma nova instância XmlReader usando as informações de fluxo, configurações e contexto especificadas para análise. |
Create(String) |
Cria uma nova instância XmlReader com o URI especificado. |
Create(String, Xml |
Cria uma nova instância XmlReader usando o URI e as configurações especificados. |
Create(String, Xml |
Cria uma nova instância XmlReader usando as informações de URI, de configurações e de contexto especificadas para análise. |
Create(Text |
Cria uma nova instância de XmlReader usando o leitor de texto especificado. |
Create(Text |
Cria uma nova instância do XmlReader usando as configurações e o leitor de texto especificados. |
Create(Text |
Cria uma nova instância XmlReader usando o leitor de texto especificado, as configurações e o URI base. |
Create(Text |
Cria uma nova instância XmlReader usando as informações de contexto, de configurações e do leitor de texto especificadas para análise. |
Create(Xml |
Cria uma nova instância XmlReader usando as configurações e o leitor XML especificados. |
Dispose() |
Libera todos os recursos usados pela instância atual da classe XmlReader. |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo XmlReader e opcionalmente libera os recursos gerenciados. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
Get |
Quando substituído em uma classe derivada, obtém o valor do atributo com o índice especificado. |
Get |
Quando substituído em uma classe derivada, obtém o valor do atributo com o Name especificado. |
Get |
Quando substituído em uma classe derivada, obtém o valor do atributo com o LocalName e o NamespaceURI especificados. |
Get |
Serve como a função de hash padrão. (Herdado de Object) |
Get |
Obtém o Type da instância atual. (Herdado de Object) |
Get |
Obtém o valor do nó atual de forma assíncrona. |
Is |
Retorna um valor que indica se o argumento de cadeia de caracteres é um nome XML válido. |
Is |
Retorna um valor que indica se o argumento de cadeia de caracteres é um token de nome XML válido. |
Is |
Chama MoveToContent() e testa se o nó de conteúdo atual é uma marca de início ou uma marca de elemento vazia. |
Is |
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. |
Is |
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. |
Lookup |
Quando substituído em uma classe derivada, resolve um prefixo de namespace no escopo do elemento atual. |
Memberwise |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
Move |
Quando substituído em uma classe derivada, é movido para o atributo com o índice especificado. |
Move |
Quando substituído em uma classe derivada, é movido para o atributo com o Name especificado. |
Move |
Quando substituído em uma classe derivada, passa para o atributo com os LocalName e NamespaceURI especificados. |
Move |
Verifica se o nó atual é um nó de conteúdo (texto sem espaço em branco, |
Move |
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. |
Move |
Quando substituído em uma classe derivada, move para o elemento que contém o nó de atributo atual. |
Move |
Quando substituído em uma classe derivada, move o primeiro atributo. |
Move |
Quando substituído em uma classe derivada, vai para o atributo seguinte. |
Read() |
Quando substituído em uma classe derivada, lê o próximo nó do fluxo. |
Read |
Lê assincronamente o próximo nó do fluxo. |
Read |
Quando substituído em uma classe derivada, analisa o valor do atributo em um ou mais nós |
Read |
Lê o conteúdo como um objeto do tipo especificado. |
Read |
Lê de forma assíncrona o conteúdo como um objeto do tipo especificado. |
Read |
Lê o conteúdo e retorna os bytes binários decodificados de Base64. |
Read |
Lê de forma assíncrona o conteúdo e retorna que os bytes binários decodificados de Base64. |
Read |
Lê o conteúdo e retorna os bytes binários decodificados |
Read |
Lê de forma assíncrona o conteúdo e retorna os bytes binários decodificados |
Read |
Lê o conteúdo de texto na posição atual como um |
Read |
Lê o conteúdo de texto na posição atual como um objeto DateTime. |
Read |
Lê o conteúdo de texto na posição atual como um objeto DateTimeOffset. |
Read |
Lê o conteúdo de texto na posição atual como um objeto Decimal. |
Read |
Lê o conteúdo de texto na posição atual como um número de ponto flutuante de precisão dupla. |
Read |
Lê o conteúdo de texto na posição atual como um número de ponto flutuante de precisão simples. |
Read |
Lê o conteúdo de texto na posição atual como um inteiro com sinal de 32 bits. |
Read |
Lê o conteúdo de texto na posição atual como um inteiro com sinal de 64 bits. |
Read |
Lê o conteúdo do texto na posição atual como um Object. |
Read |
Lê de forma assíncrona o conteúdo do texto na posição atual como um Object. |
Read |
Lê o conteúdo de texto na posição atual como um objeto String. |
Read |
Lê de forma assíncrona o conteúdo do texto na posição atual como um objeto String. |
Read |
Lê o conteúdo do elemento como o tipo solicitado. |
Read |
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. |
Read |
Lê de forma assíncrona o conteúdo do elemento como o tipo solicitado. |
Read |
Lê o elemento e decodifica o conteúdo de |
Read |
Lê de forma assíncrona o elemento e decodifica o conteúdo |
Read |
Lê o elemento e decodifica o conteúdo de |
Read |
Lê de forma assíncrona o elemento e decodifica o conteúdo |
Read |
Lê o elemento atual e retorna o conteúdo como um objeto Boolean. |
Read |
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. |
Read |
Lê o elemento atual e retorna o conteúdo como um objeto DateTime. |
Read |
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. |
Read |
Lê o elemento atual e retorna o conteúdo como um objeto Decimal. |
Read |
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. |
Read |
Lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão dupla. |
Read |
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. |
Read |
Lê o elemento atual e retorna o conteúdo como um número de ponto flutuante de precisão simples. |
Read |
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. |
Read |
Lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 32 bits. |
Read |
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. |
Read |
Lê o elemento atual e retorna o conteúdo como um inteiro com sinal de 64 bits. |
Read |
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. |
Read |
Lê o elemento atual e retorna os conteúdos como um Object. |
Read |
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. |
Read |
Lê de forma assíncrona o elemento atual e retorna o conteúdo como um Object. |
Read |
Lê o elemento atual e retorna o conteúdo como um objeto String. |
Read |
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. |
Read |
Lê de forma assíncrona o elemento atual e retorna o conteúdo como um objeto String. |
Read |
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. |
Read |
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. |
Read |
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. |
Read |
Verifica se o nó de conteúdo atual é uma marca de fim e avança o leitor para o próximo nó. |
Read |
Quando substituído em uma classe derivada, lê todo o conteúdo, incluindo a marcação, como uma cadeia de caracteres. |
Read |
Lê de forma assíncrona todo o conteúdo, inclusive a marcação, como uma cadeia de caracteres. |
Read |
Quando substituído em uma classe derivada, lê o conteúdo, inclusive a marcação, que representa esse nó e todos os seus filhos. |
Read |
Lê de forma assíncrona o conteúdo, inclusive a marcação, representando este nó e todos os seus filhos. |
Read |
Verifica se o nó atual é um elemento e avança o leitor para o próximo nó. |
Read |
Verifica se o nó de conteúdo atual é um elemento com o Name fornecido e avança o leitor para o próximo nó. |
Read |
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ó. |
Read |
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. |
Read |
Retorna uma nova instância |
Read |
Avança o XmlReader para o próximo elemento descendente com o nome qualificado especificado. |
Read |
Avança o XmlReader para o próximo elemento descendente com o nome local e URI do namespace especificados. |
Read |
Lê até que seja encontrado um elemento com o nome qualificado especificado. |
Read |
Lê até que seja encontrado um elemento com o nome do local e o URI do namespace especificados. |
Read |
Avança o |
Read |
Avança o |
Read |
Lê grandes fluxos de texto inseridos em um documento XML. |
Read |
Lê de forma assíncrona grandes fluxos de texto inserido em um documento XML. |
Resolve |
Quando substituído em uma classe derivada, resolve a referência da entidade para nós |
Skip() |
Ignora os filhos do nó atual. |
Skip |
Ignora de forma assíncrona os filhos do nó atual. |
To |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
IDisposable. |
Para obter uma descrição desse membro, confira Dispose(). |
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: