Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

JsonTokenType — tipo de token JSON

JsonTokenType es una enumeración de System.Text.Json que describe un token reconocido por Utf8JsonReader. Distingue los límites de objetos y matrices, los nombres de propiedades y los valores. None indica el estado anterior a la lectura, no el valor JSON null.

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

Sintaxis

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

JsonTokenType de System.Text.Json describe el tipo de un token. Utf8JsonReader.TokenType proporciona el tipo del último token procesado; comprueba esta propiedad después de que Read() se ejecute correctamente.

StartObject y EndObject marcan los límites de un objeto; StartArray y EndArray marcan los de una matriz. PropertyName identifica un nombre de propiedad, no su valor de cadena: para este se usa String. Los demás tipos de valor son Number, True, False y Null.

None es el estado inicial antes de leer datos, distinto del token Null. Comment representa un comentario, pero requiere JsonCommentHandling.Allow. El valor predeterminado, Disallow, rechaza los comentarios; Skip los omite sin exponer tokens.

El ejemplo muestra primero None y, después, los tipos de los tokens sucesivos. El bucle continúa mientras Read() devuelva true. Un JSON no válido puede provocar una JsonException en lugar de limitarse a terminar el bucle.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes