Compartilhar via

Utf8JsonReader Estrutura

  • Referência

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.

Aplica-se a