Utf8JsonReader Struct

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Fornisce un'API ad alte prestazioni per l'accesso di tipo forward-only e di sola lettura al testo JSON con codifica UTF-8.

public value class Utf8JsonReader

public ref struct Utf8JsonReader

type Utf8JsonReader = struct

Public Structure Utf8JsonReader

Ereditarietà

Object

ValueType

Utf8JsonReader

Commenti

Utf8JsonReader elabora il testo in sequenza senza memorizzazione nella cache e per impostazione predefinita rispetta rigorosamente l'RFC JSON.

Quando Utf8JsonReader si verifica un codice JSON non valido, genera un JsonException oggetto con informazioni di errore di base come il numero di riga e la posizione di byte sulla riga.

Poiché questo tipo è uno struct di riferimento, non supporta direttamente l'async. Tuttavia, fornisce supporto per la reentrancy per leggere i dati incompleti e continuare a leggere una volta che vengono presentati altri dati.

Per impostare la profondità massima durante la lettura OR consente di ignorare i commenti, creare un'istanza di JsonReaderOptions e passarla al lettore.

Per altre informazioni, vedere Come scrivere serializzatori personalizzati e deserialitori con System.Text.Json.

Costruttori

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.
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.
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.
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.

Proprietà

BytesConsumed	Ottiene il numero totale di byte usati finora da questa istanza di Utf8JsonReader.
CurrentDepth	Ottiene la profondità del nodo corrente.
CurrentState	Ottiene lo stato corrente di Utf8JsonReader da passare a un costruttore Utf8JsonReader con altri dati.
HasValueSequence	Ottiene un valore che indica quale proprietà Value usare per ottenere il valore del token.
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.
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>.
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.
TokenType	Ottiene il tipo dell'ultimo token JSON elaborato nel testo JSON con codifica UTF-8.
ValueIsEscaped	Ottiene un valore che indica se le proprietà correnti ValueSpan o ValueSequence contengono sequenze di escape per RFC 8259 sezione 7 e quindi richiedono l'annullamento dell'inserimento prima dell'utilizzo.
ValueSequence	Ottiene il valore non elaborato dell'ultimo token elaborato come sezione di ReadOnlySequence<byte> del payload di input, solo se il token è contenuto in diversi segmenti.
ValueSpan	Ottiene il valore non elaborato dell'ultimo token elaborato come sezione di ReadOnlySpan<byte> del payload di input, se il token è contenuto in un solo segmento o se il lettore è stato costruito con un payload JSON contenuto in un oggetto ReadOnlySpan<byte>.

Metodi

CopyString(Span<Byte>)	Copia il valore del token JSON corrente dall'origine, non generato come stringa UTF-8 nel buffer di destinazione.
CopyString(Span<Char>)	Copia il valore del token JSON corrente dall'origine, non eseguito e trascoded come buffer char UTF-16.
GetBoolean()	Legge il valore del token JSON successivo dall'origine come Boolean.
GetByte()	Analizza il valore del token JSON corrente dall'origine come oggetto Byte.
GetBytesFromBase64()	Analizza il valore del token JSON corrente dall'origine e decodifica la stringa JSON con codifica Base64 come matrice di byte.
GetComment()	Analizza il valore del token JSON corrente dall'origine come commento e lo transcodifica come String.
GetDateTime()	Legge il valore del token JSON successivo dall'origine e lo analizza come DateTime.
GetDateTimeOffset()	Legge il valore del token JSON successivo dall'origine e lo analizza come DateTimeOffset.
GetDecimal()	Legge il valore del token JSON successivo dall'origine e lo analizza come Decimal.
GetDouble()	Legge il valore del token JSON successivo dall'origine e lo analizza come Double.
GetGuid()	Legge il valore del token JSON successivo dall'origine e lo analizza come Guid.
GetInt16()	Analizza il valore del token JSON corrente dall'origine come oggetto Int16.
GetInt32()	Legge il valore del token JSON successivo dall'origine e lo analizza come Int32.
GetInt64()	Legge il valore del token JSON successivo dall'origine e lo analizza come Int64.
GetSByte()	Analizza il valore del token JSON corrente dall'origine come oggetto SByte.
GetSingle()	Legge il valore del token JSON successivo dall'origine e lo analizza come Single.
GetString()	Legge il valore del token JSON successivo dall'origine, senza caratteri di escape e transcodificato come stringa.
GetUInt16()	Analizza il valore del token JSON corrente dall'origine come oggetto UInt16.
GetUInt32()	Legge il valore del token JSON successivo dall'origine e lo analizza come UInt32.
GetUInt64()	Legge il valore del token JSON successivo dall'origine e lo analizza come UInt64.
Read()	Legge il token JSON successivo dall'origine di input.
Skip()	Ignora gli elementi figlio del token JSON corrente.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
TrySkip()	Tenta di ignorare gli elementi figlio del token JSON corrente.
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.
ValueTextEquals(ReadOnlySpan<Char>)	Confronta il testo 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.
ValueTextEquals(String)	Confronta il testo della stringa con il valore del token JSON senza caratteri di escape nell'origine e restituisce un valore che indica se corrispondono.