CKTIS / C#
JsonException — errores de datos JSON
JsonException de System.Text.Json indica que el JSON no es válido, que se ha superado el límite de anidamiento o que un valor es incompatible con el tipo de destino. También proporciona información de diagnóstico que ayuda a localizar el problema en los datos de entrada.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
catch (JsonException ex) { /* handle invalid JSON data */ }
throw new JsonException("Invalid JSON value.");JsonException es una clase de excepción del espacio de nombres System.Text.Json que hereda de Exception. Está disponible en .NET 10; no es una característica nueva del lenguaje C#. Indica una sintaxis JSON no válida, que se ha superado la profundidad máxima o que los datos son incompatibles con el tipo de destino. Por tanto, una sintaxis JSON válida no garantiza que la deserialización se realice correctamente.
Path señala la ubicación del problema en la estructura JSON. LineNumber y BytePositionInLine empiezan en cero y son de tipo long?, por lo que pueden no tener ningún valor. BytePositionInLine cuenta bytes UTF-8, no caracteres. Message describe el error; es mejor no comparar en las pruebas el mensaje completo generado por la biblioteca.
En un convertidor personalizado, use throw new JsonException("Invalid JSON value."); para rechazar un valor no aceptable. Durante la deserialización, el serializador puede rellenar Path, LineNumber y BytePositionInLine, incluso si se proporciona un mensaje propio. Si el convertidor lanza la excepción al escribir JSON, el serializador puede rellenar Path y dejar LineNumber y BytePositionInLine sin valor. El constructor que acepta un mensaje y una excepción interna permite conservar la causa subyacente.
Capture JsonException alrededor de una operación de lectura cuyo fallo pueda gestionar; no la ignore sin más. En el ejemplo, "oops" es una cadena JSON válida, pero no es compatible con la propiedad Age de tipo int. El programa muestra un mensaje fijo y la ruta $.Age, en lugar de una descripción del error que dependa del entorno.
Ejemplos
using System;
using System.Text.Json;
internal static class Program
{
private static void Main()
{
const string json = "{\"Age\":\"oops\"}";
try
{
JsonSerializer.Deserialize<Person>(json);
Console.WriteLine("Accepted");
}
catch (JsonException ex)
{
Console.WriteLine("Rejected JSON value");
Console.WriteLine($"Path: {ex.Path}");
}
}
}
public sealed class Person
{
public int Age { get; set; }
}Resultado
Rejected JSON value Path: $.Age
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.