CKTIS / C#
JsonException — napake podatkov JSON
JsonException iz System.Text.Json označuje neveljaven JSON, preseženo omejitev gnezdenja ali vrednost, ki ni združljiva s ciljnim tipom. Ponuja tudi diagnostične informacije, ki pomagajo najti težavo v vhodnih podatkih.
Različica: .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 razred izjem v imenskem prostoru System.Text.Json, ki deduje iz Exception. Na voljo je v .NET 10; ne gre za novo funkcijo jezika C#. Označuje neveljavno sintakso JSON, preseženo največjo globino ali podatke, ki niso združljivi s ciljnim tipom. Veljavna sintaksa JSON torej ne zagotavlja uspešne deserializacije.
Path označuje mesto težave v strukturi JSON. LineNumber in BytePositionInLine se začneta z nič in sta tipa long?, zato morda nimata vrednosti. BytePositionInLine šteje bajte UTF-8, ne znakov. Message opisuje napako; v preskusih raje ne primerjajte celotnega sporočila, ki ga ustvari knjižnica.
V lastnem pretvorniku uporabite throw new JsonException("Invalid JSON value.");, da zavrnete nesprejemljivo vrednost. Med deserializacijo lahko serializator nastavi Path, LineNumber in BytePositionInLine, tudi če podate lastno sporočilo. Če pretvornik sproži izjemo med pisanjem JSON-a, lahko serializator nastavi Path, vrednosti LineNumber in BytePositionInLine pa pusti nenastavljeni. Konstruktor, ki sprejme sporočilo in notranjo izjemo, omogoča ohranitev osnovnega vzroka.
JsonException prestrezite okoli operacije branja, katere napako lahko obravnavate; izjeme ne prezrite. V primeru je "oops" veljaven niz JSON, vendar ni združljiv z lastnostjo Age tipa int. Program izpiše stalno sporočilo in pot $.Age, ne pa opisa napake, odvisnega od okolja.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.