Utf8JsonReader Utf8JsonReader Utf8JsonReader Utf8JsonReader Struct

Définition

Fournit une API hautes performances pour un accès en transfert seul et en lecture seule à du texte JSON encodé en 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
Héritage
Utf8JsonReaderUtf8JsonReaderUtf8JsonReaderUtf8JsonReader

Remarques

Utf8JsonReadertraite le texte de façon séquentielle sans mise en cache et adhère par défaut strictement à la RFC JSON.Utf8JsonReader processes the text sequentially with no caching and by default adheres strictly to the JSON RFC.

Lorsque Utf8JsonReader rencontre un JSON non valide, il lève une JsonException avec des informations d’erreur de base telles que le numéro de ligne et la position d’octet sur la ligne.When Utf8JsonReader encounters invalid JSON, it throws a JsonException with basic error information like line number and byte position on the line.

Comme ce type est un struct REF, il ne prend pas directement en charge Async.Since this type is a ref struct, it doesn't directly support async. Toutefois, il prend en charge la réentrance pour lire les données incomplètes et poursuivre la lecture une fois qu’un plus grand nombre de données sont présentées.However, it does provide support for reentrancy to read incomplete data and to continue reading once more data is presented.

Pour pouvoir définir la profondeur maximale lors de la lecture ou de l’autorisation des commentaires ignorés, JsonReaderState créez une instance de et transmettez-la au lecteur.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderState and pass it to the reader.

Constructeurs

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

Initialise une nouvelle instance de la structure Utf8JsonReader qui traite une séquence en lecture seule de texte encodé en UTF-8 à l’aide des options spécifiées.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)

Initialise une nouvelle instance de la structure Utf8JsonReader qui traite une étendue en lecture seule de texte encodé en UTF-8 à l’aide des options spécifiées.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)

Initialise une nouvelle instance de la structure Utf8JsonReader qui traite une séquence en lecture seule de texte encodé en UTF-8 et indique si l’entrée contient tout le texte à traiter.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)

Initialise une nouvelle instance de la structure Utf8JsonReader qui traite une étendue en lecture seule de texte encodé en UTF-8 et indique si l’entrée contient tout le texte à traiter.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.

Propriétés

BytesConsumed BytesConsumed BytesConsumed BytesConsumed

Obtient le nombre total d’octets consommés jusqu’à présent par cette instance du Utf8JsonReader.Gets the total number of bytes consumed so far by this instance of the Utf8JsonReader.

CurrentDepth CurrentDepth CurrentDepth CurrentDepth

Obtient la profondeur du jeton actuel.Gets the depth of the current token.

CurrentState CurrentState CurrentState CurrentState

Obtient l’état Utf8JsonReader actuel à passer à un constructeur Utf8JsonReader avec davantage de données.Gets the current Utf8JsonReader state to pass to a Utf8JsonReader constructor with more data.

HasValueSequence HasValueSequence HasValueSequence HasValueSequence

Obtient une valeur qui indique quelle propriété Value utiliser pour obtenir la valeur du jeton.Gets a value that indicates which Value property to use to get the token value.

IsFinalBlock IsFinalBlock IsFinalBlock IsFinalBlock

Obtient le mode de cette instance du Utf8JsonReader qui indique si toutes les données JSON ont été fournies ou s’il y a d’autres données à venir.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

Obtient la SequencePosition actuelle dans la ReadOnlySequence<byte> de l’entrée encodée en UTF-8 fournie ou la SequencePosition par défaut si le struct Utf8JsonReader a été construit avec un 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

Obtient l’index à partir duquel commence le dernier jeton JSON traité (dans le texte d’entrée encodé en UTF-8 donné), en ignorant tout espace blanc.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

Obtient le type du dernier jeton JSON traité dans le texte JSON encodé en UTF-8.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text.

ValueSequence ValueSequence ValueSequence ValueSequence

Obtient la valeur du dernier jeton traité comme section ReadOnlySpan<T> de la charge utile de l’entrée.Gets the value of the last processed token as a ReadOnlySpan<T> slice of the input payload. Si le texte JSON est fourni dans un ReadOnlySequence<T> et que la section qui représente la valeur du jeton rentre dans un seul segment, ValueSpan contient la valeur sectionnée dans la mesure où il peut être représenté comme étendue.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. Sinon, la ValueSequence contient la valeur du jeton.Otherwise, ValueSequence contains the token value.

ValueSpan ValueSpan ValueSpan ValueSpan

Obtient la valeur du dernier jeton traité comme section ReadOnlySpan<byte> de la charge utile de l’entrée.Gets the value of the last processed token as a ReadOnlySpan<byte> slice of the input payload. Si le texte JSON est fourni dans une ReadOnlySequence<byte> et que la section qui représente la valeur du jeton rentre dans un seul segment, ValueSpan contient la valeur sectionnée dans la mesure où il peut être représenté comme étendue.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. Sinon, la ValueSequence contient la valeur du jeton.Otherwise, the ValueSequence contains the token value.

Méthodes

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

Lit la prochaine valeur du jeton JSON de la source comme Boolean.Reads the next JSON token value from the source as a Boolean.

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

Analyse la valeur du jeton JSON actuelle de la source comme Byte.Parses the current JSON token value from the source as a Byte.

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

Analyse la valeur actuelle du jeton JSON à partir de la source et décode la chaîne JSON encodée en Base64 en tant que tableau d’octets.Parses the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array.

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

Analyse la valeur actuelle du jeton JSON à partir de la source en tant que commentaire, transcodé en String.Parses the current JSON token value from the source as a comment, transcoded it as a String.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur DateTime.Reads the next JSON token value from the source and parses it to a DateTime.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur DateTimeOffset.Reads the next JSON token value from the source and parses it to a DateTimeOffset.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur Decimal.Reads the next JSON token value from the source and parses it to a Decimal.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur Double.Reads the next JSON token value from the source and parses it to a Double.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur Guid.Reads the next JSON token value from the source and parses it to a Guid.

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

Analyse la valeur du jeton JSON actuelle de la source comme Int16.Parses the current JSON token value from the source as a Int16.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur Int32.Reads the next JSON token value from the source and parses it to an Int32.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur Int64.Reads the next JSON token value from the source and parses it to an Int64.

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

Analyse la valeur du jeton JSON actuelle de la source comme SByte.Parses the current JSON token value from the source as an SByte.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur Single.Reads the next JSON token value from the source and parses it to a Single.

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

Lit la prochaine valeur du jeton JSON de la source, non échappée et transcodée, comme une chaîne.Reads the next JSON token value from the source, unescaped, and transcoded as a string.

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

Analyse la valeur du jeton JSON actuelle de la source comme UInt16.Parses the current JSON token value from the source as a UInt16.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur UInt32.Reads the next JSON token value from the source and parses it to a UInt32.

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

Lit la prochaine valeur du jeton JSON de la source et l’analyse pour obtenir une valeur UInt64.Reads the next JSON token value from the source and parses it to a UInt64.

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

Lit le prochain jeton JSON de la source d’entrée.Reads the next JSON token from the input source.

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

Ignore les enfants du jeton JSON actuel.Skips the children of the current JSON token.

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

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Byte et retourne une valeur qui indique si l’opération a réussi.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[])

Tente d’analyser la valeur du jeton JSON actuelle de la source et décode la chaîne JSON encodée en Base64 en tant que tableau d’octets et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que DateTime et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que DateTimeOffset et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Decimal et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Double et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Guid et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Int16 et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Int32 et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Int64 et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que SByte et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que Single et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que UInt16 et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que UInt32 et retourne une valeur qui indique si l’opération a réussi.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)

Tente d’analyser la valeur du jeton JSON actuelle de la source en tant que UInt64 et retourne une valeur qui indique si l’opération a réussi.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()

Tente d’ignorer les enfants du jeton JSON actuel.Tries to skip the children of the current JSON token.

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

Compare le texte encodé en UTF-8 dans une étendue en lecture seule d’octets à la valeur du jeton JSON sans séquence d’échappement dans la source et retourne une valeur qui indique s’ils correspondent.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>)

Compare le texte encodé en UTF-8 dans une étendue en lecture seule de caractères à la valeur du jeton JSON sans séquence d’échappement dans la source et retourne une valeur qui indique s’ils correspondent.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)

Compare le texte dans une étendue en lecture seule de caractères à la valeur du jeton JSON sans séquence d’échappement dans la source et retourne une valeur qui indique s’ils correspondent.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.

S’applique à