Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri