Utf8JsonReader Utf8JsonReader Utf8JsonReader Utf8JsonReader Struct

Definição

Fornece uma API de alto desempenho para acesso somente leitura e somente de encaminhamento ao texto JSON codificado em UTF-8.Provides a high-performance API for forward-only, read-only access to UTF-8 encoded JSON text.

public value class Utf8JsonReader
public struct Utf8JsonReader
type Utf8JsonReader = struct
Public Structure Utf8JsonReader
Herança
Utf8JsonReaderUtf8JsonReaderUtf8JsonReaderUtf8JsonReader

Comentários

Utf8JsonReaderprocessa o texto sequencialmente sem cache e, por padrão, segue estritamente para a RFC JSON.Utf8JsonReader processes the text sequentially with no caching and by default adheres strictly to the JSON RFC.

Quando Utf8JsonReader o encontra um JSON inválido, ele JsonException gera uma com informações básicas de erro, como número de linha e posição de byte na linha.When Utf8JsonReader encounters invalid JSON, it throws a JsonException with basic error information like line number and byte position on the line.

Como esse tipo é uma struct de referência, ele não dá suporte diretamente a Async.Since this type is a ref struct, it doesn't directly support async. No entanto, ele fornece suporte para reentrância a fim de ler dados incompletos e continuar lendo quando mais dados forem apresentados.However, it does provide support for reentrancy to read incomplete data and to continue reading once more data is presented.

Para poder definir a profundidade máxima ao ler ou permitir comentários ignorados, crie uma instância do JsonReaderOptions e passe-a para o leitor.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderOptions and pass it to the reader.

Construtores

Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) 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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only sequence of UTF-8 encoded text using the specified options.

Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions) 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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only span of UTF-8 encoded text using the specified options.

Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) 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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only sequence of UTF-8 encoded text and indicates whether the input contains all the text to process.

Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState) 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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only span of UTF-8 encoded text and indicates whether the input contains all the text to process.

Propriedades

BytesConsumed BytesConsumed BytesConsumed BytesConsumed

Obtém o número total de bytes consumidos até o momento por esta instância do Utf8JsonReader.Gets the total number of bytes consumed so far by this instance of the Utf8JsonReader.

CurrentDepth CurrentDepth CurrentDepth CurrentDepth

Obtém a profundidade do token atual.Gets the depth of the current token.

CurrentState CurrentState CurrentState CurrentState

Obtém o estado de Utf8JsonReader atual para ser passado para um construtor Utf8JsonReader com mais dados.Gets the current Utf8JsonReader state to pass to a Utf8JsonReader constructor with more data.

HasValueSequence HasValueSequence HasValueSequence HasValueSequence

Obtém um valor que indica qual propriedade de Valor deve ser usada para obter o valor do token.Gets a value that indicates which Value property to use to get the token value.

IsFinalBlock IsFinalBlock IsFinalBlock 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.Gets the mode of this instance of the Utf8JsonReader which indicates whether all the JSON data was provided or there is more data to come.

Position Position Position 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>.Gets the current SequencePosition within the provided UTF-8 encoded input ReadOnlySequence<byte> or a default SequencePosition if the Utf8JsonReader struct was constructed with a ReadOnlySpan<byte>.

TokenStartIndex TokenStartIndex TokenStartIndex 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.Gets the index that the last processed JSON token starts at (within the given UTF-8 encoded input text), skipping any white space.

TokenType TokenType TokenType TokenType

Obtém o tipo do último token JSON processado em texto JSON codificado em UTF-8.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text.

ValueSequence ValueSequence ValueSequence 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.Gets the raw value of the last processed token as a ReadOnlySequence<byte> slice of the input payload, only if the token is contained within multiple segments.

ValueSpan ValueSpan ValueSpan 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>.Gets the raw value of the last processed token as a ReadOnlySpan<byte> slice of the input payload, if the token fits in a single segment or if the reader was constructed with a JSON payload contained in a ReadOnlySpan<byte>.

Métodos

GetBoolean() GetBoolean() GetBoolean() GetBoolean()

Lê o próximo valor do token JSON da fonte como um Boolean.Reads the next JSON token value from the source as a Boolean.

GetByte() GetByte() GetByte() GetByte()

Analisa o valor do token JSON atual da fonte como um Byte.Parses the current JSON token value from the source as a Byte.

GetBytesFromBase64() GetBytesFromBase64() GetBytesFromBase64() 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.Parses the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array.

GetComment() GetComment() GetComment() GetComment()

Analisa o valor do token JSON atual da origem como um comentário, transcodificando-o como um String.Parses the current JSON token value from the source as a comment, transcoded it as a String.

GetDateTime() GetDateTime() GetDateTime() GetDateTime()

Lê o próximo valor de token JSON da fonte e analisa-o para um DateTime.Reads the next JSON token value from the source and parses it to a DateTime.

GetDateTimeOffset() GetDateTimeOffset() GetDateTimeOffset() GetDateTimeOffset()

Lê o próximo valor de token JSON da fonte e analisa-o para um DateTimeOffset.Reads the next JSON token value from the source and parses it to a DateTimeOffset.

GetDecimal() GetDecimal() GetDecimal() GetDecimal()

Lê o próximo valor de token JSON da fonte e analisa-o para um Decimal.Reads the next JSON token value from the source and parses it to a Decimal.

GetDouble() GetDouble() GetDouble() GetDouble()

Lê o próximo valor de token JSON da fonte e analisa-o para um Double.Reads the next JSON token value from the source and parses it to a Double.

GetGuid() GetGuid() GetGuid() GetGuid()

Lê o próximo valor de token JSON da fonte e analisa-o para um Guid.Reads the next JSON token value from the source and parses it to a Guid.

GetInt16() GetInt16() GetInt16() GetInt16()

Analisa o valor do token JSON atual da fonte como um Int16.Parses the current JSON token value from the source as a Int16.

GetInt32() GetInt32() GetInt32() GetInt32()

Lê o próximo valor de token JSON da fonte e analisa-o para um Int32.Reads the next JSON token value from the source and parses it to an Int32.

GetInt64() GetInt64() GetInt64() GetInt64()

Lê o próximo valor de token JSON da fonte e analisa-o para um Int64.Reads the next JSON token value from the source and parses it to an Int64.

GetSByte() GetSByte() GetSByte() GetSByte()

Analisa o valor do token JSON atual da fonte como um SByte.Parses the current JSON token value from the source as an SByte.

GetSingle() GetSingle() GetSingle() GetSingle()

Lê o próximo valor de token JSON da fonte e analisa-o para um Single.Reads the next JSON token value from the source and parses it to a Single.

GetString() GetString() GetString() GetString()

Lê o próximo valor do token JSON da fonte, sem escape e transcodificado como uma cadeia de caracteres.Reads the next JSON token value from the source, unescaped, and transcoded as a string.

GetUInt16() GetUInt16() GetUInt16() GetUInt16()

Analisa o valor do token JSON atual da fonte como um UInt16.Parses the current JSON token value from the source as a UInt16.

GetUInt32() GetUInt32() GetUInt32() GetUInt32()

Lê o próximo valor de token JSON da fonte e analisa-o para um UInt32.Reads the next JSON token value from the source and parses it to a UInt32.

GetUInt64() GetUInt64() GetUInt64() GetUInt64()

Lê o próximo valor de token JSON da fonte e analisa-o para um UInt64.Reads the next JSON token value from the source and parses it to a UInt64.

Read() Read() Read() Read()

Lê o próximo token JSON da fonte de entrada.Reads the next JSON token from the input source.

Skip() Skip() Skip() Skip()

Ignora os filhos do token JSON atual.Skips the children of the current JSON token.

TryGetByte(Byte) TryGetByte(Byte) TryGetByte(Byte) 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.Tries to parse the current JSON token value from the source as a Byte and returns a value that indicates whether the operation succeeded.

TryGetBytesFromBase64(Byte[]) TryGetBytesFromBase64(Byte[]) TryGetBytesFromBase64(Byte[]) 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.Tries to parse the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array and returns a value that indicates whether the operation succeeded.

TryGetDateTime(DateTime) TryGetDateTime(DateTime) TryGetDateTime(DateTime) 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.Tries to parse the current JSON token value from the source as a DateTime and returns a value that indicates whether the operation succeeded.

TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset) 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.Tries to parse the current JSON token value from the source as a DateTimeOffset and returns a value that indicates whether the operation succeeded.

TryGetDecimal(Decimal) TryGetDecimal(Decimal) TryGetDecimal(Decimal) 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.Tries to parse the current JSON token value from the source as a Decimal and returns a value that indicates whether the operation succeeded.

TryGetDouble(Double) TryGetDouble(Double) TryGetDouble(Double) 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.Tries to parse the current JSON token value from the source as a Double and returns a value that indicates whether the operation succeeded.

TryGetGuid(Guid) TryGetGuid(Guid) TryGetGuid(Guid) 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.Tries to parse the current JSON token value from the source as a Guid and returns a value that indicates whether the operation succeeded.

TryGetInt16(Int16) TryGetInt16(Int16) TryGetInt16(Int16) 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.Tries to parse the current JSON token value from the source as an Int16 and returns a value that indicates whether the operation succeeded.

TryGetInt32(Int32) TryGetInt32(Int32) TryGetInt32(Int32) 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.Tries to parse the current JSON token value from the source as an Int32 and returns a value that indicates whether the operation succeeded.

TryGetInt64(Int64) TryGetInt64(Int64) TryGetInt64(Int64) 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.Tries to parse the current JSON token value from the source as an Int64 and returns a value that indicates whether the operation succeeded.

TryGetSByte(SByte) TryGetSByte(SByte) TryGetSByte(SByte) 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.Tries to parse the current JSON token value from the source as an SByte and returns a value that indicates whether the operation succeeded.

TryGetSingle(Single) TryGetSingle(Single) TryGetSingle(Single) 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.Tries to parse the current JSON token value from the source as a Single and returns a value that indicates whether the operation succeeded.

TryGetUInt16(UInt16) TryGetUInt16(UInt16) TryGetUInt16(UInt16) 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.Tries to parse the current JSON token value from the source as a UInt16 and returns a value that indicates whether the operation succeeded.

TryGetUInt32(UInt32) TryGetUInt32(UInt32) TryGetUInt32(UInt32) 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.Tries to parse the current JSON token value from the source as a UInt32 and returns a value that indicates whether the operation succeeded.

TryGetUInt64(UInt64) TryGetUInt64(UInt64) TryGetUInt64(UInt64) 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.Tries to parse the current JSON token value from the source as a UInt64 and returns a value that indicates whether the operation succeeded.

TrySkip() TrySkip() TrySkip() TrySkip()

Tenta ignorar os filhos do token JSON atual.Tries to skip the children of the current JSON token.

ValueTextEquals(ReadOnlySpan<Byte>) ValueTextEquals(ReadOnlySpan<Byte>) ValueTextEquals(ReadOnlySpan<Byte>) 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.Compares the UTF-8 encoded text in a read-only byte span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

ValueTextEquals(ReadOnlySpan<Char>) ValueTextEquals(ReadOnlySpan<Char>) ValueTextEquals(ReadOnlySpan<Char>) 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.Compares the text in a read-only character span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

ValueTextEquals(String) ValueTextEquals(String) ValueTextEquals(String) 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.Compares the string text to the unescaped JSON token value in the source and returns a value that indicates whether they match.

Aplica-se a