Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori