Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes