Utf8JsonReader Utf8JsonReader Utf8JsonReader Utf8JsonReader Struct

Definition

Bietet eine leistungsstarke API für schreibgeschützten Zugriff auf den UTF-8-codierten JSON-Text in Vorwärtsrichtung.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
Vererbung
Utf8JsonReaderUtf8JsonReaderUtf8JsonReaderUtf8JsonReader

Hinweise

Utf8JsonReader Prozesse, die der Text nacheinander mit kein Zwischenspeichern und in der Standardeinstellung entspricht genau zu der JSON RFC.Utf8JsonReader processes the text sequentially with no caching and by default adheres strictly to the JSON RFC.

Wenn Utf8JsonReader trifft Ungültiges JSON-Format, löst er eine JsonReaderException mit grundlegenden Informationen wie Anzahl und die Byte-Position der Zeile in der Zeile.When Utf8JsonReader encounters invalid JSON, it throws a JsonReaderException with basic error information like line number and byte position on the line. Da dieser Typ eine Verweisstruktur ist, unterstützt nicht direkt asynchronen.Since this type is a ref struct, it doesn't directly support async. Es bietet jedoch Unterstützung für erneutes eintreten, um unvollständige Daten zu lesen, und fahren, sobald weitere Daten dargestellt werden.However, it does provide support for reentrancy to read incomplete data and to continue reading once more data is presented. In der Lage, legen Sie die maximale Tiefe während des Lesens oder zulassen, wird übersprungen, Kommentare, erstellen Sie eine Instanz des JsonReaderState und übergeben es an dem Reader.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderState and pass it to the reader.

Konstruktoren

Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState)

Initialisiert eine neue Instanz der Utf8JsonReader-Klasse.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)

Initialisiert eine neue Instanz der Utf8JsonReader-Klasse.Initializes a new instance of the Utf8JsonReader class.

Eigenschaften

BytesConsumed BytesConsumed BytesConsumed BytesConsumed

Ruft die Gesamtzahl der Bytes ab, die bisher vom Utf8JsonReader für die aktuelle Instanz von Utf8JsonReader mit dem angegebenen UTF-8-codierten Eingabetext verwendet wurden.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

Ruft die Tiefe des aktuellen Tokens ab.Gets the depth of the current token.

CurrentState CurrentState CurrentState CurrentState

Ruft die aktuelle Momentaufnahme des Zustands von Utf8JsonReader ab, der vom Aufrufer erfasst und an den Utf8JsonReader-Konstruktor mit weiteren Daten zurückgegeben werden muss.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

Ruft einen Wert an, der angibt, welche Value-Eigenschaft zum Abrufen des Tokenwerts zu verwenden ist.Gets a value that indicates which Value property to use to get the token value.

Position Position Position Position

Ruft die aktuelle SequencePosition innerhalb des bereitgestellten UTF-8-codierten ReadOnlySequence<Byte> der Eingabe oder einen SequencePosition-Standardwert ab, wenn die Utf8JsonReader-Struktur mit einem ReadOnlySpan<Byte> erstellt wurde.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>.

TokenType TokenType TokenType TokenType

Ruft den Typ des zuletzt verarbeiteten JSON-Tokens im UTF-8-codierten JSON-Text ab.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text.

ValueSequence ValueSequence ValueSequence ValueSequence

Ruft den Wert des zuletzt verarbeiteten Tokens als einen ReadOnlySpan<Byte>-Slice der Eingabenutzlast ab.Gets the value of the last processed token as a ReadOnlySpan<byte> slice of the input payload. Wenn der JSON-Code innerhalb eines ReadOnlySequence<Byte> bereitgestellt wird und der Slice, der den Tokenwert darstellt, in ein einzelnes Segment passt, enthält ValueSpan den Slicewert, da es als ein Bereich dargestellt werden kann.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. Andernfalls enthält ValueSequence den Tokenwert.Otherwise, ValueSequence contains the token value.

ValueSpan ValueSpan ValueSpan ValueSpan

Ruft den Wert des zuletzt verarbeiteten Tokens als einen ReadOnlySpan<Byte>-Slice der Eingabenutzlast ab.Gets the value of the last processed token as a ReadOnlySpan<byte> slice of the input payload. Wenn der JSON-Code innerhalb eines ReadOnlySequence<Byte> bereitgestellt wird und der Slice, der den Tokenwert darstellt, in ein einzelnes Segment passt, enthält ValueSpan den Slicewert, da es als ein Bereich dargestellt werden kann.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. Andernfalls enthält ValueSequence den Tokenwert.Otherwise, the ValueSequence contains the token value.

Methoden

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

Liest den nächsten JSON-Tokenwert aus der Quelle als einen Boolean-Wert.Reads the next JSON token value from the source as a Boolean.

GetDateTime() GetDateTime() GetDateTime() GetDateTime()
GetDateTimeOffset() GetDateTimeOffset() GetDateTimeOffset() GetDateTimeOffset()
GetDecimal() GetDecimal() GetDecimal() GetDecimal()

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Decimal-Wert.Reads the next JSON token value from the source and parses it to a Decimal.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Double-Wert.Reads the next JSON token value from the source and parses it to a Double.

GetGuid() GetGuid() GetGuid() GetGuid()
GetInt32() GetInt32() GetInt32() GetInt32()

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Int32-Wert.Reads the next JSON token value from the source and parses it to an Int32.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Int64-Wert.Reads the next JSON token value from the source and parses it to an Int64.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Single-Wert.Reads the next JSON token value from the source and parses it to a Single.

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

Liest den nächsten JSON-Tokenwert aus der Quelle, ohne Escapezeichen und als String-Wert transcodiert.Reads the next JSON token value from the source, unescaped, and transcoded as a String.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen UInt32-Wert.Reads the next JSON token value from the source and parses it to a UInt32.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen UInt64-Wert.Reads the next JSON token value from the source and parses it to a UInt64.

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

Lesen des nächsten JSON-Tokens aus der Eingabequelle.Read the next JSON token from the input source.

TextEquals(ReadOnlySpan<Byte>) TextEquals(ReadOnlySpan<Byte>) TextEquals(ReadOnlySpan<Byte>) TextEquals(ReadOnlySpan<Byte>)
TextEquals(ReadOnlySpan<Char>) TextEquals(ReadOnlySpan<Char>) TextEquals(ReadOnlySpan<Char>) TextEquals(ReadOnlySpan<Char>)
TryGetDateTime(DateTime) TryGetDateTime(DateTime) TryGetDateTime(DateTime) TryGetDateTime(DateTime)
TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset) TryGetDateTimeOffset(DateTimeOffset)
TryGetDecimal(Decimal) TryGetDecimal(Decimal) TryGetDecimal(Decimal) TryGetDecimal(Decimal)

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Decimal-Wert.Reads the next JSON token value from the source and parses it to a Decimal.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Double-Wert.Reads the next JSON token value from the source and parses it to a Double.

TryGetGuid(Guid) TryGetGuid(Guid) TryGetGuid(Guid) TryGetGuid(Guid)
TryGetInt32(Int32) TryGetInt32(Int32) TryGetInt32(Int32) TryGetInt32(Int32)

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Int32-Wert.Reads the next JSON token value from the source and parses it to an Int32.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Int64-Wert.Reads the next JSON token value from the source and parses it to an Int64.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen Single-Wert.Reads the next JSON token value from the source and parses it to a Single.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen UInt32-Wert.Reads the next JSON token value from the source and parses it to a UInt32.

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

Liest den nächsten JSON-Tokenwert aus der Quelle und analysiert ihn in einen UInt64-Wert.Reads the next JSON token value from the source and parses it to a UInt64.

Gilt für: