CKTIS / C#
JsonTokenType — tipo de token JSON
JsonTokenType é uma enumeração de System.Text.Json que descreve um token reconhecido por Utf8JsonReader. Distingue os limites de objetos e matrizes, os nomes das propriedades e os valores. None indica o estado antes da leitura, não o valor JSON null.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
JsonTokenType tokenType = reader.TokenType;
if (tokenType == JsonTokenType.Null) { /* ... */ }JsonTokenType em System.Text.Json descreve o tipo de um token. Utf8JsonReader.TokenType indica o tipo do último token processado; consulte esta propriedade após uma chamada bem-sucedida a Read().
StartObject e EndObject assinalam os limites de um objeto; StartArray e EndArray assinalam os de uma matriz. PropertyName identifica o nome de uma propriedade, não o respetivo valor de cadeia: para este usa-se String. Os outros tipos de valor são Number, True, False e Null.
None é o estado inicial, antes da leitura dos dados, e é diferente do token Null. Comment representa um comentário, mas requer JsonCommentHandling.Allow. O valor predefinido, Disallow, rejeita comentários; Skip ignora-os sem expor tokens.
O exemplo apresenta primeiro None e, em seguida, os tipos dos tokens sucessivos. O ciclo continua enquanto Read() devolver true. Um JSON inválido pode lançar uma JsonException, em vez de simplesmente terminar o ciclo.
Exemplos
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);
}Resultado
None StartObject PropertyName String PropertyName True PropertyName Null EndObject
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.