Utf8JsonReader Structure

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
Utf8JsonReader

Remarques

Utf8JsonReader traite le texte séquentiellement 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, créez une instance de JsonReaderOptions et transmettez-la au lecteur.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderOptions and pass it to the reader.

Pour plus d’informations, consultez sérialisation et désérialisation de JSON.For more information, see How to serialize and deserialize JSON.

Constructeurs

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

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.

Propriétés

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

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

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

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

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

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

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

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

Obtient la valeur brute du dernier jeton traité en tant que section ReadOnlySequence<byte> de la charge utile d’entrée, uniquement si le jeton est contenu dans plusieurs segments.Gets the raw value of the last processed token as a ReadOnlySequence<byte> slice of the input payload, only if the token is contained within multiple segments.

ValueSpan

Obtient la valeur brute du dernier jeton traité en tant que section ReadOnlySpan<byte> de la charge utile d’entrée, si le jeton entre dans un seul segment ou si le lecteur a été construit avec une charge utile JSON contenue dans un ReadOnlySpan<byte>.Gets the raw value of the last processed token as a ReadOnlySpan<byte> slice of the input payload, if the token fits in a single segment or if the reader was constructed with a JSON payload contained in a ReadOnlySpan<byte>.

Méthodes

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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

Skip()

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

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[])

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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()

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

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

Compare le texte dans une étendue en lecture seule de caractères en lecture seule à 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 read-only character span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

ValueTextEquals(String)

Compare le texte de chaîne à la valeur du jeton JSON sans séquence d’échappement dans la source et retourne une valeur qui indique s’ils correspondent.Compares the string text to the unescaped JSON token value in the source and returns a value that indicates whether they match.

S’applique à