CKTIS / C#
JsonException — chyby dat JSON
JsonException z System.Text.Json signalizuje neplatné JSON, překročení limitu vnoření nebo hodnotu nekompatibilní s cílovým typem. Poskytuje také diagnostické informace, které pomáhají najít problém ve vstupních datech.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
catch (JsonException ex) { /* handle invalid JSON data */ }
throw new JsonException("Invalid JSON value.");JsonException je třída výjimky v oboru názvů System.Text.Json, která dědí z Exception. Je dostupná v .NET 10; nejde o novou funkci jazyka C#. Signalizuje neplatnou syntaxi JSON, překročení maximální hloubky nebo data nekompatibilní s cílovým typem. Platná syntaxe JSON tedy nezaručuje úspěšnou deserializaci.
Path označuje místo problému ve struktuře JSON. LineNumber a BytePositionInLine jsou číslované od nuly a mají typ long?, takže nemusí obsahovat žádnou hodnotu. BytePositionInLine počítá bajty UTF-8, nikoli znaky. Message popisuje chybu; v testech raději neporovnávejte celou zprávu vytvořenou knihovnou.
Ve vlastním převaděči použijte throw new JsonException("Invalid JSON value."); k odmítnutí nepřijatelné hodnoty. Při deserializaci může serializátor vyplnit Path, LineNumber a BytePositionInLine, i když zadáte vlastní zprávu. Pokud převaděč vyvolá výjimku při zápisu JSON, může serializátor vyplnit Path a ponechat LineNumber a BytePositionInLine bez hodnoty. Konstruktor přijímající zprávu a vnitřní výjimku umožňuje zachovat původní příčinu.
Výjimku JsonException zachytávejte kolem operace čtení, jejíž selhání dokážete zpracovat; výjimku tiše neignorujte. V příkladu je "oops" platný řetězec JSON, ale není kompatibilní s vlastností Age typu int. Program vypíše pevnou zprávu a cestu $.Age, nikoli popis chyby závislý na prostředí.
Pří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ýsledek
Rejected JSON value Path: $.Age
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.