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 the UTF-8 encoded JSON text.

public value class Utf8JsonReader
public struct Utf8JsonReader
type Utf8JsonReader = struct
Public Structure Utf8JsonReader
Ereditarietà
Utf8JsonReaderUtf8JsonReaderUtf8JsonReaderUtf8JsonReader

Commenti

Utf8JsonReader il testo in modo sequenziale con nessuna memorizzazione nella cache e per impostazione predefinita è conforme esclusivamente a processi di JSON RFC.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 <xref:System.Text.Json.JsonReaderException> con le informazioni di base dell'errore, ad esempio numero e byte la posizione nella riga.When Utf8JsonReader encounters invalid JSON, it throws a <xref:System.Text.Json.JsonReaderException> with basic error information like line number and byte position on the line.

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

Per essere in grado di impostare la profondità massima durante la lettura o consentono di ignorare i commenti, creare un'istanza di JsonReaderState e passarlo 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>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState)

Inizializza una nuova istanza della classe Utf8JsonReader.Initializes a new instance of the Utf8JsonReader class.

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 classe Utf8JsonReader.Initializes a new instance of the Utf8JsonReader class.

Proprietà

BytesConsumed BytesConsumed BytesConsumed BytesConsumed

Ottiene il numero totale di byte utilizzati da Utf8JsonReader finora per l'istanza corrente di Utf8JsonReader con il testo di input con codifica UTF-8 specificato.Gets the total number of bytes consumed by the Utf8JsonReader so far for the current instance of the Utf8JsonReader with the given UTF-8 encoded input text.

CurrentDepth CurrentDepth CurrentDepth CurrentDepth

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

CurrentState CurrentState CurrentState CurrentState

Ottiene lo snapshot corrente dello stato Utf8JsonReader che deve essere acquisito dal chiamante e passato al costruttore Utf8JsonReader con altri dati.Gets the current snapshot of the Utf8JsonReader state that must be captured by the caller and passed back in to the 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
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
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<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, 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.

GetBytesFromBase64() GetBytesFromBase64() GetBytesFromBase64() GetBytesFromBase64()
GetComment() GetComment() GetComment() GetComment()
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.

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.

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 String.Reads the next JSON token value from the source, unescaped, and transcoded as a String.

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.Read the next JSON token from the input source.

Skip() Skip() Skip() Skip()
TextEquals(ReadOnlySpan<Byte>) TextEquals(ReadOnlySpan<Byte>) TextEquals(ReadOnlySpan<Byte>) TextEquals(ReadOnlySpan<Byte>)

Confronta il testo con codifica UTF-8 con il valore del token JSON senza caratteri di escape nell'origine e restituisce true se corrispondono.Compares the UTF-8 encoded text to the unescaped JSON token value in the source and returns true if they match.

TextEquals(ReadOnlySpan<Char>) TextEquals(ReadOnlySpan<Char>) TextEquals(ReadOnlySpan<Char>) TextEquals(ReadOnlySpan<Char>)

Confronta il testo con codifica UTF-16 al valore del token JSON senza caratteri di escape nell'origine e restituisce true se corrispondono.Compares the UTF-16 encoded text to the unescaped JSON token value in the source and returns true if they match.

TryGetBytesFromBase64(Byte[]) TryGetBytesFromBase64(Byte[]) TryGetBytesFromBase64(Byte[]) TryGetBytesFromBase64(Byte[])
TryGetDateTime(DateTime) TryGetDateTime(DateTime) TryGetDateTime(DateTime) TryGetDateTime(DateTime)

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.

TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset)

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.

TryGetDecimal(Decimal) TryGetDecimal(Decimal) TryGetDecimal(Decimal) TryGetDecimal(Decimal)

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.

TryGetDouble(Double) TryGetDouble(Double) TryGetDouble(Double) TryGetDouble(Double)

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.

TryGetGuid(Guid) TryGetGuid(Guid) TryGetGuid(Guid) TryGetGuid(Guid)

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.

TryGetInt32(Int32) TryGetInt32(Int32) TryGetInt32(Int32) TryGetInt32(Int32)

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.

TryGetInt64(Int64) TryGetInt64(Int64) TryGetInt64(Int64) TryGetInt64(Int64)

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.

TryGetSingle(Single) TryGetSingle(Single) TryGetSingle(Single) TryGetSingle(Single)

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.

TryGetUInt32(UInt32) TryGetUInt32(UInt32) TryGetUInt32(UInt32) TryGetUInt32(UInt32)

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.

TryGetUInt64(UInt64) TryGetUInt64(UInt64) TryGetUInt64(UInt64) TryGetUInt64(UInt64)

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.

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

Si applica a