База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

JsonException — грешки в JSON данни

JsonException от System.Text.Json сигнализира за невалиден JSON, надвишено ограничение за влагане или стойност, несъвместима с целевия тип. Предоставя и диагностична информация, която помага да се открие проблемът във входните данни.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

catch (JsonException ex) { /* handle invalid JSON data */ }
throw new JsonException("Invalid JSON value.");

JsonException е клас за изключения в пространството от имена System.Text.Json, който наследява Exception. Наличен е в .NET 10; това не е нова функция на езика C#. Сигнализира за невалиден синтаксис на JSON, надвишена максимална дълбочина или данни, несъвместими с целевия тип. Следователно валидният синтаксис на JSON не гарантира успешна десериализация.

Path посочва местоположението на проблема в структурата на JSON. LineNumber и BytePositionInLine се индексират от нула и са от тип long?, затова може да нямат стойност. BytePositionInLine брои UTF-8 байтове, а не знаци. Message описва грешката; в тестовете е по-добре да не сравнявате цялото съобщение, генерирано от библиотеката.

В потребителски конвертор използвайте throw new JsonException("Invalid JSON value.");, за да отхвърлите неприемлива стойност. При десериализация сериализаторът може да попълни Path, LineNumber и BytePositionInLine, дори когато зададете собствено съобщение. Ако конверторът хвърли изключението при запис на JSON, сериализаторът може да попълни Path, като остави LineNumber и BytePositionInLine без стойност. Конструкторът, който приема съобщение и вътрешно изключение, позволява да запазите първопричината.

Улавяйте JsonException около операция за четене, чийто неуспех можете да обработите; не я пренебрегвайте мълчаливо. В примера "oops" е валиден JSON низ, но е несъвместим със свойството Age от тип int. Програмата извежда фиксирано съобщение и пътя $.Age, вместо описание на грешката, зависещо от средата.

Примери

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; }
}

Резултат

Rejected JSON value
Path: $.Age

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници