Utf8JsonReader Estrutura

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Fornece uma API de alto desempenho para acesso somente leitura e somente de encaminhamento ao texto JSON codificado em UTF-8.

public value class Utf8JsonReader

public ref struct Utf8JsonReader

type Utf8JsonReader = struct

Public Structure Utf8JsonReader

Herança

Object

ValueType

Utf8JsonReader

Comentários

Utf8JsonReader processa o texto sequencialmente sem cache e, por padrão, segue estritamente o RFC JSON.

Quando Utf8JsonReader encontra JSON inválido, ele lança uma JsonException com informações básicas de erro, como número de linha e posição de byte na linha.

Como esse tipo é um struct ref, ele não dá suporte direto à assíncrona. No entanto, ele fornece suporte para que a reentração leia dados incompletos e continue lendo mais uma vez que os dados sejam apresentados.

Para poder definir a profundidade máxima ao ler OU permitir ignorar comentários, crie uma instância JsonReaderOptions e passe-a para o leitor.

Para obter mais informações, consulte Como escrever serializadores e desserializadores personalizados com System.Text.Json.

Construtores

Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState)	Inicializa uma nova instância da estrutura Utf8JsonReader que processa uma sequência somente leitura de texto codificado em UTF-8 e indica se a entrada contém todo o texto a ser processado.
Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions)	Inicializa uma nova instância da estrutura Utf8JsonReader que processa uma sequência somente leitura de texto codificado em UTF-8 usando as opções especificadas.
Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState)	Inicializa uma nova instância da estrutura Utf8JsonReader que processa um intervalo somente leitura de texto codificado em UTF-8 e indica se a entrada contém todo o texto a ser processado.
Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions)	Inicializa uma nova instância da estrutura Utf8JsonReader que processa um intervalo somente leitura de texto codificado em UTF-8 usando as opções especificadas.

Propriedades

BytesConsumed	Obtém o número total de bytes consumidos até o momento por esta instância do Utf8JsonReader.
CurrentDepth	Obtém a profundidade do token atual.
CurrentState	Obtém o estado de Utf8JsonReader atual para ser passado para um construtor Utf8JsonReader com mais dados.
HasValueSequence	Obtém um valor que indica qual propriedade de Valor deve ser usada para obter o valor do token.
IsFinalBlock	Obtém o modo dessa instância do Utf8JsonReader que indica se todos os dados JSON foram fornecidos ou se há mais dados a receber.
Position	Obtém a SequencePosition atual dentro do ReadOnlySequence<byte> de entrada codificado em UTF-8 fornecido ou uma SequencePosition padrão se o struct Utf8JsonReader foi construído com um ReadOnlySpan<byte>.
TokenStartIndex	Obtém o índice em que o último token JSON processado começa (dentro do texto de entrada codificado em UTF-8 fornecido), ignorando qualquer espaço em branco.
TokenType	Obtém o tipo do último token JSON processado em texto JSON codificado em UTF-8.
ValueIsEscaped	Obtém um valor que indica se as propriedades atuais ValueSpan ou ValueSequence de escape contêm sequências de escape por RFC 8259 seção 7 e, portanto, exigem desescaping antes de serem consumidas.
ValueSequence	Obtém o valor bruto do último token processado como uma fatia de ReadOnlySequence<byte> do conteúdo de entrada, somente se o token estiver contido em vários segmentos.
ValueSpan	Obtém o valor bruto do último token processado como uma fatia de ReadOnlySpan<byte> do conteúdo de entrada, se o token couber em um único segmento ou se o leitor foi construído com um conteúdo JSON contido em um ReadOnlySpan<byte>.

Métodos

CopyString(Span<Byte>)	Copia o valor atual do token JSON da origem, sem escape como uma cadeia de caracteres UTF-8 para o buffer de destino.
CopyString(Span<Char>)	Copia o valor atual do token JSON da origem, sem escape e transcodificado como um buffer de caracteres UTF-16.
GetBoolean()	Lê o próximo valor do token JSON da fonte como um Boolean.
GetByte()	Analisa o valor do token JSON atual da fonte como um Byte.
GetBytesFromBase64()	Analisa o valor do token JSON atual da origem e decodifica a cadeia de caracteres JSON codificada em Base64 como uma matriz de bytes.
GetComment()	Analisa o valor do token JSON atual da origem como um comentário, transcodificando-o como um String.
GetDateTime()	Lê o próximo valor de token JSON da fonte e analisa-o para um DateTime.
GetDateTimeOffset()	Lê o próximo valor de token JSON da fonte e analisa-o para um DateTimeOffset.
GetDecimal()	Lê o próximo valor de token JSON da fonte e analisa-o para um Decimal.
GetDouble()	Lê o próximo valor de token JSON da fonte e analisa-o para um Double.
GetGuid()	Lê o próximo valor de token JSON da fonte e analisa-o para um Guid.
GetInt16()	Analisa o valor do token JSON atual da fonte como um Int16.
GetInt32()	Lê o próximo valor de token JSON da fonte e analisa-o para um Int32.
GetInt64()	Lê o próximo valor de token JSON da fonte e analisa-o para um Int64.
GetSByte()	Analisa o valor do token JSON atual da fonte como um SByte.
GetSingle()	Lê o próximo valor de token JSON da fonte e analisa-o para um Single.
GetString()	Lê o próximo valor do token JSON da fonte, sem escape e transcodificado como uma cadeia de caracteres.
GetUInt16()	Analisa o valor do token JSON atual da fonte como um UInt16.
GetUInt32()	Lê o próximo valor de token JSON da fonte e analisa-o para um UInt32.
GetUInt64()	Lê o próximo valor de token JSON da fonte e analisa-o para um UInt64.
Read()	Lê o próximo token JSON da fonte de entrada.
Skip()	Ignora os filhos do token JSON atual.
TryGetByte(Byte)	Tenta analisar o valor do token JSON atual da origem como um Byte e retorna um valor que indica se a operação foi bem-sucedida.
TryGetBytesFromBase64(Byte[])	Tenta analisar o valor do token JSON atual da origem, decodifica a cadeia de caracteres JSON codificada em Base64 como uma matriz de bytes e retorna um valor que indica se a operação foi bem-sucedida.
TryGetDateTime(DateTime)	Tenta analisar o valor do token JSON atual da origem como um DateTime e retorna um valor que indica se a operação foi bem-sucedida.
TryGetDateTimeOffset(DateTimeOffset)	Tenta analisar o valor do token JSON atual da origem como um DateTimeOffset e retorna um valor que indica se a operação foi bem-sucedida.
TryGetDecimal(Decimal)	Tenta analisar o valor do token JSON atual da origem como um Decimal e retorna um valor que indica se a operação foi bem-sucedida.
TryGetDouble(Double)	Tenta analisar o valor do token JSON atual da origem como um Double e retorna um valor que indica se a operação foi bem-sucedida.
TryGetGuid(Guid)	Tenta analisar o valor do token JSON atual da origem como um Guid e retorna um valor que indica se a operação foi bem-sucedida.
TryGetInt16(Int16)	Tenta analisar o valor do token JSON atual da origem como um Int16 e retorna um valor que indica se a operação foi bem-sucedida.
TryGetInt32(Int32)	Tenta analisar o valor do token JSON atual da origem como um Int32 e retorna um valor que indica se a operação foi bem-sucedida.
TryGetInt64(Int64)	Tenta analisar o valor do token JSON atual da origem como um Int64 e retorna um valor que indica se a operação foi bem-sucedida.
TryGetSByte(SByte)	Tenta analisar o valor do token JSON atual da origem como um SByte e retorna um valor que indica se a operação foi bem-sucedida.
TryGetSingle(Single)	Tenta analisar o valor do token JSON atual da origem como um Single e retorna um valor que indica se a operação foi bem-sucedida.
TryGetUInt16(UInt16)	Tenta analisar o valor do token JSON atual da origem como um UInt16 e retorna um valor que indica se a operação foi bem-sucedida.
TryGetUInt32(UInt32)	Tenta analisar o valor do token JSON atual da origem como um UInt32 e retorna um valor que indica se a operação foi bem-sucedida.
TryGetUInt64(UInt64)	Tenta analisar o valor do token JSON atual da origem como um UInt64 e retorna um valor que indica se a operação foi bem-sucedida.
TrySkip()	Tenta ignorar os filhos do token JSON atual.
ValueTextEquals(ReadOnlySpan<Byte>)	Compara o texto codificado em UTF-8 em um intervalo de bytes somente leitura com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.
ValueTextEquals(ReadOnlySpan<Char>)	Compara o texto em um intervalo de caracteres somente leitura com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.
ValueTextEquals(String)	Compara o texto da cadeia de caracteres com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.