CKTIS / C#
JsonException — fouten in JSON-gegevens
JsonException uit System.Text.Json geeft aan dat JSON ongeldig is, de nestellingslimiet is overschreden of een waarde niet bij het doeltype past. De uitzondering biedt ook diagnostische informatie waarmee het probleem in de invoer kan worden gevonden.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
catch (JsonException ex) { /* handle invalid JSON data */ }
throw new JsonException("Invalid JSON value.");JsonException is een uitzonderingsklasse in de naamruimte System.Text.Json die overerft van Exception. De klasse is beschikbaar in .NET 10; het is geen nieuwe functie van de C#-taal. Ze geeft ongeldige JSON-syntaxis, een overschreden maximale diepte of gegevens die niet bij het doeltype passen aan. Geldige JSON-syntaxis garandeert dus geen geslaagde deserialisatie.
Path geeft de locatie van het probleem in de JSON-structuur aan. LineNumber en BytePositionInLine beginnen bij nul en hebben het type long?; ze kunnen dus zonder waarde blijven. BytePositionInLine telt UTF-8-bytes, geen tekens. Message beschrijft de fout; vergelijk in tests liever niet het volledige bericht dat de bibliotheek genereert.
Gebruik in een aangepaste converter throw new JsonException("Invalid JSON value."); om een onaanvaardbare waarde af te wijzen. Tijdens deserialisatie kan de serializer Path, LineNumber en BytePositionInLine invullen, ook als u zelf een bericht opgeeft. Als de converter de uitzondering genereert tijdens het schrijven van JSON, kan de serializer Path invullen en LineNumber en BytePositionInLine oningevuld laten. Met de constructor die een bericht en een inner exception accepteert, kunt u de onderliggende oorzaak behouden.
Vang JsonException op rond een leesbewerking waarvan u de fout kunt afhandelen; negeer de uitzondering niet stilzwijgend. In het voorbeeld is "oops" een geldige JSON-tekenreeks, maar past deze niet bij de eigenschap Age van het type int. Het programma drukt een vast bericht en het pad $.Age af, in plaats van een omgevingsafhankelijke foutbeschrijving.
Voorbeelden
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; }
}Resultaat
Rejected JSON value Path: $.Age
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.