Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje