• Ähnlich wie im vorherigen Abschnitt
• Wir können einen JSON‑String in ein Array umwandeln
• Ersetze einfach den ursprünglichen Klassennamen durch List<Klassenname>

Beispiel

string jsonString = @"""{""webinfos"":[{""webname"":""FoxDevelop"",""website"":""foxdevelop.com"",""age"":4,
""students"":[{""name"":""Ben""},{""name"":""Paul""}]},{""webname"":""FoxDevelop1"",""website"":""foxdevelop.com1"",
""age"":6,""students"":[{""name"":""Lukas""},{""name"":""Finn""}]}]}""";

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

Hinweise

1. Code‑Struktur, Variablennamen, maskierte Anführungszeichen und Zeilenumbrüche beibehalten, nur Zieltext ersetzen
2. Nachfolgende Deserialisierungs‑Logik nicht verändern

① List zu JSON‑Array‑String serialisieren

// List‑Collection aufbauen
List<WebInfo> webList = new List<WebInfo>()
{
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="Ben"}, new Person{name="Paul"} }
    },
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop1",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="Lukas"}, new Person{name="Finn"} }
    },
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop2",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="Noel"}, new Person{name="Jonas"} }
    }
};

// Serialisierung: List‑Objekt → JSON‑Array‑String
StringWriter sw = new StringWriter();
JsonWriter writer = new JsonWriter(sw);
new JsonSerializer().Serialize(writer, webList);
string jsonArrStr = sw.GetStringBuilder().ToString();

② JSON‑Array‑String zu List deserialisieren

string jsonString = @"[{"webname":"FoxDevelop","website":"foxdevelop.com","age":4,
"students":[{"name":"Ben"},{"name":"Paul"}]},{"webname":"FoxDevelop1","website":"foxdevelop.com",
"age":4,"students":[{"name":"Lukas"},{"name":"Finn"}]},{"webname":"FoxDevelop2","website":"foxdevelop.com",
"age":4,"students":[{"name":"Noel"},{"name":"Jonas"}]}]";

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

Serialisierung und Deserialisierung von Arrays

Zurück zur Serialisierung aus dem vorherigen Abschnitt: sie wandelt ein Entity‑Objekt in einen JSON‑String um.

Serialisierung

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" } };
// Wandelt das webinfo‑Objekt in einen JSON‑String um
StringWriter sw = new StringWriter();
JsonWriter writer = new JsonWriter(sw);
new JsonSerializer().Serialize(writer, webInfo);
string json = sw.GetStringBuilder().ToString();

Erzeugtes JSON‑Ergebnis

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

Deserialisierung

Einen JSON‑String zurück in ein Entity‑Objekt umwandeln

Methode 1 (niedrigstufige Reader‑Schreibweise)

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

Methode 2 (kompakte generische Schreibweise, Newtonsoft.Json)

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

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

Mit diesen Methoden lassen sich JSON‑Daten zu Entity‑Objekten deserialisieren.

Es geht auch so

JavaScriptConvert.DeserializeObject<NodeInfo>(jsonText)

Serialisierung und Deserialisierung

Newtonsoft.Json (häufig Json.NET genannt) ist eine Open‑Source‑Bibliothek für JSON‑Serialisierung und‑Deserialisierung im .NET‑Ökosystem

• Erste Version Json.NET 1.0.1 erschien 2006, aktuelle Hauptversionen liegen bei 10+
• Ursprünglich für .NET 2.0 entwickelt, unterstützt nahezu alle .NET‑Frameworks (Framework/.NET Core/.NET 5+)
• Assembly: Newtonsoft.Json.dll, Installation über NuGet
• Quellcode wurde ursprünglich auf CodePlex gehostet, heute auf GitHub; weit verbreitet in Unternehmensprojekten

2. Was ist JSON

JSON（JavaScript Object Notation）

• Leichtes, sprachunabhängiges Textformat für Datenaustausch, nicht nur für JavaScript
• Kernstruktur: Schlüssel‑Wert‑Paar key:value；Verschachtelte Objekte {} und Arrays [] werden unterstützt

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

II. Entity‑Klasse definieren (passend zur JSON‑Struktur)

Person.cs (Student‑Objekt)

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

WebInfo.cs (Wurzel‑Objekt)

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

Beispiel‑Objekt zu JSON serialisieren

protected void Page_Load(object sender, EventArgs e)
{
    // 1. Entity‑Objekt erstellen und Werte zuweisen
    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. Newtonsoft.Json Low‑Level‑Code: Serialisierung per JsonWriter
    StringWriter sw = new StringWriter();
    JsonWriter writer = new JsonWriter(sw);
    new JsonSerializer().Serialize(writer, webInfo);
    string json = sw.GetStringBuilder().ToString();
}

Einfache Schreibweise für den Alltag

Newtonsoft.Json stellt statische Hilfsmethoden zur Verfügung, sodass man JsonWriter nicht manuell erzeugen muss:

// Einzeilige Serialisierung, im Entwicklungsalltag sehr gebräuchlich
string json = JsonConvert.SerializeObject(webInfo);

Ausgabe‑JSON‑Ergebnis

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

Weitere Hinweise

• System.Text.Json：von Microsoft integrierte JSON‑Bibliothek ab .NET Core 3.0; für ältere .NET‑Framework‑Projekte wird Newtonsoft.Json nach wie vor häufig verwendet
• Eigenschaften: Eigenschafts‑Aliase, Feld‑Ignorierung, Datumsformatierung, Behandlung zirkulärer Verweise und weitere erweiterte Funktionen

Einführung