• Comme dans la section précédente
• Nous pouvons convertir une chaîne JSON en tableau
• Il suffit de remplacer le nom de classe original par List<NomClasse>

Exemple

string jsonString = @"""{""webinfos"":[{""webname"":""FoxDevelop"",""website"":""foxdevelop.com"",""age"":4,
""students"":[{""name"":""Lucas""},{""name"":""Hugo""}]},{""webname"":""FoxDevelop1"",""website"":""foxdevelop.com1"",
""age"":6,""students"":[{""name"":""Léo""},{""name"":""Gabriel""}]}]}""";

StringReader sr = new StringReader(jsonString);
JsonReader jr = new JsonReader(sr);
List<WebInfo> infoList = new JsonSerializer().Deserialize(jr, typeof(List<WebInfo>)) as List<WebInfo>;

Remarques

1. Conserver structure, noms de variables, guillemets échappés et sauts de ligne, ne remplacer que le texte cible
2. Ne pas modifier le code de désérialisation suivant

① Sérialiser une List en chaîne tableau JSON

// Construire la collection List
List<WebInfo> webList = new List<WebInfo>()
{
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="Lucas"}, new Person{name="Hugo"} }
    },
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop1",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="Léo"}, new Person{name="Gabriel"} }
    },
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop2",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="Arthur"}, new Person{name="Mathis"} }
    }
};

// Sérialisation : Objet List → chaîne tableau JSON
StringWriter sw = new StringWriter();
JsonWriter writer = new JsonWriter(sw);
new JsonSerializer().Serialize(writer, webList);
string jsonArrStr = sw.GetStringBuilder().ToString();

② Désérialiser une chaîne tableau JSON en List

string jsonString = @"[{"webname":"FoxDevelop","website":"foxdevelop.com","age":4,
"students":[{"name":"Lucas"},{"name":"Hugo"}]},{"webname":"FoxDevelop1","website":"foxdevelop.com",
"age":4,"students":[{"name":"Léo"},{"name":"Gabriel"}]},{"webname":"FoxDevelop2","website":"foxdevelop.com",
"age":4,"students":[{"name":"Arthur"},{"name":"Mathis"}]}]";

StringReader sr = new StringReader(jsonString);
JsonReader jr = new JsonTextReader(sr);
List<WebInfo> dataList = new JsonSerializer().Deserialize(jr, typeof(List<WebInfo>)) as List<WebInfo>;

Sérialisation et désérialisation de tableaux

Revenons sur la sérialisation vue au chapitre précédent : elle convertit un objet entité en chaîne JSON.

Sérialisation

WebInfo webInfo = new WebInfo();
webInfo.age = 4;
webInfo.webname = "FoxDevelop";
webInfo.website = "foxdevelop.com";
webInfo.students = new Person[] { new Person { name = "Tom" }, new Person { name = "Jim" } };
// Convertir l’objet webinfo en chaîne JSON
StringWriter sw = new StringWriter();
JsonWriter writer = new JsonWriter(sw);
new JsonSerializer().Serialize(writer, webInfo);
string json = sw.GetStringBuilder().ToString();

Résultat JSON généré

{"webname":"FoxDevelop","website":"foxdevelop.com","age":4,"students":[{"name":"Zhang San"},{"name":"Li Si"}]}

Désérialisation

Transformer une chaîne JSON en objet entité

Méthode 1 (écriture bas‑niveau avec Reader)

WebInfo model = new JsonSerializer()
    .Deserialize(new JsonTextReader(new StringReader(json)), typeof(WebInfo)) as WebInfo;

Méthode 2 (syntaxe générique concise, Newtonsoft.Json)

WebInfo model = JavaScriptConvert.DeserializeObject<WebInfo>(json);

new JsonSerializer().Deserialize(new JsonTextReader(new StringReader(jsonString)), typeof(NomClasse) as NomClasse

Grâce à ces méthodes, on peut désérialiser un JSON vers un objet entité.

Autre forme d’appel

JavaScriptConvert.DeserializeObject<NodeInfo>(jsonText)

Sérialisation et désérialisation

Newtonsoft.Json (communément appelé Json.NET) est une bibliothèque open source de sérialisation‑désérialisation JSON pour l’écosystème .NET

• Première version Json.NET 1.0.1 sortie en 2006, les versions majeures dépassent aujourd’hui la version 10
• Initialement compatible avec .NET 2.0, fonctionne avec quasiment tous les frameworks .NET (Framework/.NET Core/.NET 5+)
• Assembly : Newtonsoft.Json.dll, installez‑le via NuGet
• Le code source était hébergé sur CodePlex, il est maintenant migré sur GitHub, très utilisé dans de nombreux projets d’entreprise

2. Qu’est‑ce que JSON

JSON（JavaScript Object Notation）

• Format d’échange de données textuel léger et indépendant des langages, il n’est pas exclusif à JavaScript
• Structure de base : paire clé‑valeur key:value ; prend en charge les objets imbriqués {} et les tableaux []

{"webname":"FoxDevelop","website":"foxdevelop.com","age":4,"students":[{"name":"tom"},{"name":"bill"}]}

II. Définition des classes d’entité (correspondance avec la structure JSON)

Person.cs (objet étudiant)

namespace NewtonsoftDemo
{
    public class Person
    {
        public string name { set; get; }
    }
}

WebInfo.cs (objet racine)

namespace NewtonsoftDemo
{
    public class WebInfo
    {
        public string webname { set; get; }
        public string website { set; get; }
        public int age { set; get; }
        public Person[] students { set; get; }
    }
}

Exemple‑Sérialiser un objet en JSON

protected void Page_Load(object sender, EventArgs e)
{
    // 1. Instancier l’entité et affecter les valeurs
    WebInfo webInfo = new WebInfo();
    webInfo.age = 4;
    webInfo.webname = "FoxDevelop";
    webInfo.website = "foxdevelop.com";
    webInfo.students = new Person[] 
    { 
        new Person { name = "TOM" },
        new Person { name = "JACK" } 
    };

    // 2. Écriture bas niveau Newtonsoft.Json : sérialisation avec JsonWriter
    StringWriter sw = new StringWriter();
    JsonWriter writer = new JsonWriter(sw);
    new JsonSerializer().Serialize(writer, webInfo);
    string json = sw.GetStringBuilder().ToString();
}

Syntaxe simplifiée pour un usage quotidien

Newtonsoft.Json propose des méthodes statiques utilitaires, inutile d’instancier manuellement JsonWriter :

// Sérialisation en une ligne, très utilisée en développement
string json = JsonConvert.SerializeObject(webInfo);

Résultat JSON de sortie

{
  "webname": "FoxDevelop",
  "website": "foxdevelop.com",
  "age": "4",
  "students": [
    {"name":"TOM"},
    {"name":"JACK"}
  ]
}

Autres points

• System.Text.Json : bibliothèque JSON intégrée Microsoft depuis .NET Core 3.0 ; Newtonsoft.Json reste très répandu sur les anciens projets .NET Framework
• Fonctionnalités : alias de propriétés, exclusion de champs, formatage des dates, gestion des références circulaires et autres fonctions avancées

Présentation