CKTIS / C#
JsonException — pogreške JSON podataka
JsonException iz System.Text.Json označava nevaljan JSON, prekoračenje ograničenja ugniježđenosti ili vrijednost koja nije kompatibilna s ciljnim tipom. Pruža i dijagnostičke informacije koje pomažu pronaći problem u ulaznim podacima.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
catch (JsonException ex) { /* handle invalid JSON data */ }
throw new JsonException("Invalid JSON value.");JsonException je klasa iznimke u prostoru naziva System.Text.Json koja nasljeđuje Exception. Dostupna je u .NET 10; nije nova značajka jezika C#. Označava nevaljanu sintaksu JSON-a, prekoračenje najveće dubine ili podatke koji nisu kompatibilni s ciljnim tipom. Valjana sintaksa JSON-a stoga ne jamči uspješnu deserijalizaciju.
Path označava mjesto problema u strukturi JSON-a. LineNumber i BytePositionInLine indeksirani su od nule i tipa su long?, pa možda nemaju vrijednost. BytePositionInLine broji UTF-8 bajtove, a ne znakove. Message opisuje pogrešku; u testovima je bolje ne uspoređivati cijelu poruku koju generira biblioteka.
U prilagođenom pretvaraču upotrijebite throw new JsonException("Invalid JSON value."); da biste odbili neprihvatljivu vrijednost. Tijekom deserijalizacije serijalizator može popuniti Path, LineNumber i BytePositionInLine, čak i ako navedete vlastitu poruku. Ako pretvarač baci iznimku pri pisanju JSON-a, serijalizator može popuniti Path, a LineNumber i BytePositionInLine ostaviti bez vrijednosti. Konstruktor koji prihvaća poruku i unutarnju iznimku omogućuje očuvanje osnovnog uzroka.
Uhvatite JsonException oko operacije čitanja čiju pogrešku možete obraditi; nemojte je prešutno zanemariti. U primjeru je "oops" valjan JSON niz, ali nije kompatibilan sa svojstvom Age tipa int. Program ispisuje fiksnu poruku i put $.Age, umjesto opisa pogreške koji ovisi o okruženju.
Primjeri
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; }
}Rezultat
Rejected JSON value Path: $.Age
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.