Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

JsonTokenType — tipo di token JSON

JsonTokenType è un'enumerazione di System.Text.Json che descrive un token riconosciuto da Utf8JsonReader. Distingue i limiti di oggetti e array, i nomi delle proprietà e i valori. None indica lo stato precedente alla lettura, non il valore JSON null.

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

Sintassi

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

JsonTokenType in System.Text.Json descrive il tipo di un token. Utf8JsonReader.TokenType espone il tipo dell’ultimo token elaborato; controlla questa proprietà dopo che Read() è stato completato correttamente.

StartObject e EndObject indicano i limiti di un oggetto; StartArray e EndArray indicano quelli di un array. PropertyName identifica un nome di proprietà, non il suo valore stringa: per quest’ultimo si usa String. Gli altri tipi di valore sono Number, True, False e Null.

None è lo stato iniziale prima della lettura dei dati, distinto dal token Null. Comment rappresenta un commento, ma richiede JsonCommentHandling.Allow. Il valore predefinito, Disallow, rifiuta i commenti; Skip li ignora senza esporre token.

L’esempio stampa prima None, quindi i tipi dei token successivi. Il ciclo continua finché Read() restituisce true. Un JSON non valido può generare JsonException, invece di limitarsi a terminare il ciclo.

Esempi

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

Risultato

None
StartObject
PropertyName
String
PropertyName
True
PropertyName
Null
EndObject

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti