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.