Utf8JsonReader Utf8JsonReader Utf8JsonReader Utf8JsonReader Struct

Definizione

Fornisce un'API ad alte prestazioni per l'accesso di tipo forward-only e di sola lettura al testo JSON con codifica 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
Ereditarietà
Utf8JsonReaderUtf8JsonReaderUtf8JsonReaderUtf8JsonReader

Commenti

Utf8JsonReaderelabora il testo in sequenza senza caching e per impostazione predefinita si attiene esclusivamente alla RFC JSON.Utf8JsonReader processes the text sequentially with no caching and by default adheres strictly to the JSON RFC.

Quando Utf8JsonReader rileva JSON non valido, genera un' JsonException eccezione con informazioni di base sull'errore, come il numero di riga e la posizione di byte sulla riga.When Utf8JsonReader encounters invalid JSON, it throws a JsonException with basic error information like line number and byte position on the line.

Poiché questo tipo è uno struct Ref, non supporta direttamente Async.Since this type is a ref struct, it doesn't directly support async. Tuttavia, fornisce il supporto per la rientranza per leggere i dati incompleti e per continuare a leggere una volta che vengono presentati più dati.However, it does provide support for reentrancy to read incomplete data and to continue reading once more data is presented.

Per poter impostare la profondità massima durante la lettura o la possibilità di ignorare i commenti, creare un' JsonReaderState istanza di e passarla al lettore.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderState and pass it to the reader.

Costruttori

Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions)

Inizializza una nuova istanza della struttura Utf8JsonReader che elabora una sequenza di sola lettura del testo con codifica UTF-8 usando le opzioni specificate.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)

Inizializza una nuova istanza della struttura Utf8JsonReader che elabora un intervallo di sola lettura del testo con codifica UTF-8 usando le opzioni specificate.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)

Inizializza una nuova istanza della struttura Utf8JsonReader che elabora una sequenza di sola lettura del testo con codifica UTF-8 e indica se l'input contiene tutto il testo da elaborare.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)

Inizializza una nuova istanza della struttura Utf8JsonReader che elabora un intervallo di sola lettura del testo con codifica UTF-8 e indica se l'input contiene tutto il testo da elaborare.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.

Proprietà

BytesConsumed BytesConsumed BytesConsumed BytesConsumed

Ottiene il numero totale di byte usati finora da questa istanza di Utf8JsonReader.Gets the total number of bytes consumed so far by this instance of the Utf8JsonReader.

CurrentDepth CurrentDepth CurrentDepth CurrentDepth

Ottiene la profondità del nodo corrente.Gets the depth of the current token.

CurrentState CurrentState CurrentState CurrentState

Ottiene lo stato corrente di Utf8JsonReader da passare a un costruttore Utf8JsonReader con altri dati.Gets the current Utf8JsonReader state to pass to a Utf8JsonReader constructor with more data.

HasValueSequence HasValueSequence HasValueSequence HasValueSequence

Ottiene un valore che indica quale proprietà Value usare per ottenere il valore del token.Gets a value that indicates which Value property to use to get the token value.

IsFinalBlock IsFinalBlock IsFinalBlock IsFinalBlock

Ottiene la modalità di questa istanza di Utf8JsonReader, che indica se sono stati specificati tutti i dati JSON o se sono previsti altri dati.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

Ottiene l'oggetto corrente SequencePosition all'interno della sequenza ReadOnlySequence<byte> di input con codifica UTF-8 fornita o una SequencePosition predefinita se lo struct Utf8JsonReader è stato costruito con 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

Ottiene l'indice in corrispondenza del quale inizia l'ultimo token JSON elaborato (all'interno del testo di input con codifica UTF-8 specificato), ignorando eventuali spazi vuoti.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

Ottiene il tipo dell'ultimo token JSON elaborato nel testo JSON con codifica UTF-8.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text.

ValueSequence ValueSequence ValueSequence ValueSequence

Ottiene il valore dell'ultimo token elaborato come sezione ReadOnlySpan<T> del payload di input.Gets the value of the last processed token as a ReadOnlySpan<T> slice of the input payload. Se il token JSON viene fornito all'interno di un oggetto ReadOnlySequence<T> e la sezione che rappresenta il valore del token rientra in un singolo segmento, la proprietà ValueSpan contiene il valore suddiviso perché può essere rappresentato come un intervallo.If the JSON is provided within a ReadOnlySequence<T> and the slice that represents the token value fits in a single segment, then ValueSpan contains the sliced value since it can be represented as a span. In caso contrario, ValueSequence contiene il valore del token.Otherwise, ValueSequence contains the token value.

ValueSpan ValueSpan ValueSpan ValueSpan

Ottiene il valore dell'ultimo token elaborato come sezione ReadOnlySpan<byte> del payload di input.Gets the value of the last processed token as a ReadOnlySpan<byte> slice of the input payload. Se il token JSON viene fornito all'interno di una ReadOnlySequence<byte> e la sezione che rappresenta il valore del token rientra in un singolo segmento, ValueSpan contiene il valore suddiviso perché può essere rappresentato come un intervallo.If the JSON is provided within a ReadOnlySequence<byte> and the slice that represents the token value fits in a single segment, then ValueSpan contains the sliced value since it can be represented as a span. In caso contrario, il ValueSequence contiene il valore del token.Otherwise, the ValueSequence contains the token value.

Metodi

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

Legge il valore del token JSON successivo dall'origine come Boolean.Reads the next JSON token value from the source as a Boolean.

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

Analizza il valore del token JSON corrente dall'origine come oggetto Byte.Parses the current JSON token value from the source as a Byte.

GetBytesFromBase64() GetBytesFromBase64() GetBytesFromBase64() GetBytesFromBase64()

Analizza il valore del token JSON corrente dall'origine e decodifica la stringa JSON con codifica Base64 come matrice di byte.Parses the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array.

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

Analizza il valore del token JSON corrente dall'origine come commento e lo transcodifica come String.Parses the current JSON token value from the source as a comment, transcoded it as a String.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come DateTime.Reads the next JSON token value from the source and parses it to a DateTime.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come DateTimeOffset.Reads the next JSON token value from the source and parses it to a DateTimeOffset.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come Decimal.Reads the next JSON token value from the source and parses it to a Decimal.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come Double.Reads the next JSON token value from the source and parses it to a Double.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come Guid.Reads the next JSON token value from the source and parses it to a Guid.

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

Analizza il valore del token JSON corrente dall'origine come oggetto Int16.Parses the current JSON token value from the source as a Int16.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come Int32.Reads the next JSON token value from the source and parses it to an Int32.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come Int64.Reads the next JSON token value from the source and parses it to an Int64.

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

Analizza il valore del token JSON corrente dall'origine come oggetto SByte.Parses the current JSON token value from the source as an SByte.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come Single.Reads the next JSON token value from the source and parses it to a Single.

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

Legge il valore del token JSON successivo dall'origine, senza caratteri di escape e transcodificato come stringa.Reads the next JSON token value from the source, unescaped, and transcoded as a string.

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

Analizza il valore del token JSON corrente dall'origine come oggetto UInt16.Parses the current JSON token value from the source as a UInt16.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come UInt32.Reads the next JSON token value from the source and parses it to a UInt32.

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

Legge il valore del token JSON successivo dall'origine e lo analizza come UInt64.Reads the next JSON token value from the source and parses it to a UInt64.

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

Legge il token JSON successivo dall'origine di input.Reads the next JSON token from the input source.

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

Ignora gli elementi figlio del token JSON corrente.Skips the children of the current JSON token.

TryGetByte(Byte) TryGetByte(Byte) TryGetByte(Byte) TryGetByte(Byte)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Byte e restituisce un valore che indica se l'operazione è riuscita.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[])

Prova ad analizzare il valore del token JSON corrente dall'origine e decodifica la stringa JSON con codifica Base64 come matrice di byte e restituisce un valore che indica se l'operazione è stata completata.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto DateTime e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto DateTimeOffset e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Decimal e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Double e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Guid e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Int16 e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Int32 e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Int64 e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto SByte e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto Single e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto UInt16 e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto UInt32 e restituisce un valore che indica se l'operazione è riuscita.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)

Prova ad analizzare il valore del token JSON corrente dall'origine come oggetto UInt64 e restituisce un valore che indica se l'operazione è riuscita.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 di ignorare gli elementi figlio del token JSON corrente.Tries to skip the children of the current JSON token.

ValueTextEquals(ReadOnlySpan<Byte>) ValueTextEquals(ReadOnlySpan<Byte>) ValueTextEquals(ReadOnlySpan<Byte>) ValueTextEquals(ReadOnlySpan<Byte>)

Confronta il testo con codifica UTF-8 in un intervallo di byte di sola lettura con il valore del token JSON senza caratteri di escape nell'origine e restituisce un valore che indica se corrispondono.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>)

Confronta il testo con codifica UTF-8 in un intervallo di caratteri di sola lettura con il valore del token JSON senza caratteri di escape nell'origine e restituisce un valore che indica se corrispondono.Compares the UTF-8 encoded 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)

Confronta il testo in un intervallo di caratteri con il valore del token JSON senza caratteri di escape nell'origine e restituisce un valore che indica se corrispondono.Compares the text in a character span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

Si applica a