CKTIS / C#
JsonException — chyby údajov JSON
JsonException z System.Text.Json signalizuje neplatný JSON, prekročenie limitu vnorenia alebo hodnotu nekompatibilnú s cieľovým typom. Poskytuje aj diagnostické informácie, ktoré pomáhajú nájsť problém vo vstupných údajoch.
Verzia: .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 je trieda výnimky v mennom priestore System.Text.Json, ktorá dedí z Exception. Je dostupná v .NET 10; nejde o novú funkciu jazyka C#. Signalizuje neplatnú syntax JSON, prekročenie maximálnej hĺbky alebo údaje nekompatibilné s cieľovým typom. Platná syntax JSON teda nezaručuje úspešnú deserializáciu.
Path označuje miesto problému v štruktúre JSON. LineNumber a BytePositionInLine sú indexované od nuly a majú typ long?, preto nemusia obsahovať hodnotu. BytePositionInLine počíta bajty UTF-8, nie znaky. Message opisuje chybu; v testoch radšej neporovnávajte celú správu vytvorenú knižnicou.
Vo vlastnom konvertore použite throw new JsonException("Invalid JSON value."); na odmietnutie neprijateľnej hodnoty. Pri deserializácii môže serializátor vyplniť Path, LineNumber a BytePositionInLine, aj keď zadáte vlastnú správu. Ak konvertor vyvolá výnimku pri zápise JSON, serializátor môže vyplniť Path a ponechať LineNumber a BytePositionInLine bez hodnoty. Konštruktor prijímajúci správu a vnútornú výnimku umožňuje zachovať pôvodnú príčinu.
Výnimku JsonException zachytávajte okolo operácie čítania, ktorej zlyhanie viete spracovať; výnimku potichu neignorujte. V príklade je "oops" platný reťazec JSON, ale nie je kompatibilný s vlastnosťou Age typu int. Program vypíše pevnú správu a cestu $.Age, nie opis chyby závislý od prostredia.
Príklady
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; }
}Výsledok
Rejected JSON value Path: $.Age
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.