Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

JsonTokenType — type de jeton JSON

JsonTokenType est une énumération de System.Text.Json qui décrit un jeton reconnu par Utf8JsonReader. Elle distingue les limites des objets et des tableaux, les noms de propriétés et les valeurs. None désigne l’état avant la lecture, et non la valeur JSON null.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

JsonTokenType tokenType = reader.TokenType;
if (tokenType == JsonTokenType.Null) { /* ... */ }

JsonTokenType dans System.Text.Json décrit le type d’un jeton. Utf8JsonReader.TokenType indique le type du dernier jeton traité ; consultez cette propriété après un appel réussi à Read().

StartObject et EndObject marquent les limites d’un objet ; StartArray et EndArray marquent celles d’un tableau. PropertyName désigne un nom de propriété, et non sa valeur de type chaîne : celle-ci utilise String. Les autres types de valeur sont Number, True, False et Null.

None est l’état initial, avant la lecture des données, et se distingue du jeton Null. Comment représente un commentaire, mais nécessite JsonCommentHandling.Allow. La valeur par défaut, Disallow, rejette les commentaires ; Skip les ignore sans exposer de jetons.

L’exemple affiche d’abord None, puis les types des jetons successifs. La boucle continue tant que Read() renvoie true. Un JSON invalide peut provoquer une JsonException au lieu de simplement mettre fin à la boucle.

Exemples

using System;
using System.Text.Json;

var reader = new Utf8JsonReader("{\"name\":\"Ada\",\"active\":true,\"note\":null}"u8);
Console.WriteLine(reader.TokenType);

while (reader.Read())
{
    JsonTokenType tokenType = reader.TokenType;
    Console.WriteLine(tokenType);
}

Résultat

None
StartObject
PropertyName
String
PropertyName
True
PropertyName
Null
EndObject

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources