• 如同上一小節的做法
• 我們可以把 JSON 字串轉換成陣列
• 只需要把原本的類別名稱替換成 List<類別名稱>

範例

string jsonString = @"""{""webinfos"":[{""webname"":""FoxDevelop"",""website"":""foxdevelop.com"",""age"":4,
""students"":[{""name"":""志偉""},{""name"":""建宏""}]},{""webname"":""FoxDevelop1"",""website"":""foxdevelop.com1"",
""age"":6,""students"":[{""name"":""俊傑""},{""name"":""明輝""}]}]}""";

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

說明

1. 程式結構、變數名、跳脫雙引號、換行全部維持不變，只替換指定文字
2. 後續反序列化的程式邏輯不需要做任何修改

① List 序列化為 JSON 陣列字串

// 建立 List 集合
List<WebInfo> webList = new List<WebInfo>()
{
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="志偉"}, new Person{name="建宏"} }
    },
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop1",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="俊傑"}, new Person{name="明輝"} }
    },
    new WebInfo()
    {
        age = 4,
        webname = "FoxDevelop2",
        website = "foxdevelop.com",
        students = new Person[] { new Person{name="家豪"}, new Person{name="宗翰"} }
    }
};

// 序列化：List物件 → JSON陣列字串
StringWriter sw = new StringWriter();
JsonWriter writer = new JsonWriter(sw);
new JsonSerializer().Serialize(writer, webList);
string jsonArrStr = sw.GetStringBuilder().ToString();

② JSON 陣列字串反序列化為 List

string jsonString = @"[{"webname":"FoxDevelop","website":"foxdevelop.com","age":4,
"students":[{"name":"志偉"},{"name":"建宏"}]},{"webname":"FoxDevelop1","website":"foxdevelop.com",
"age":4,"students":[{"name":"俊傑"},{"name":"明輝"}]},{"webname":"FoxDevelop2","website":"foxdevelop.com",
"age":4,"students":[{"name":"家豪"},{"name":"宗翰"}]}]";

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

陣列的序列化與反序列化

回顧上一小節的序列化，作用是把實體物件轉換成 JSON 字串。

序列化

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" } };
// 將 webinfo 物件轉換為 JSON 字串
StringWriter sw = new StringWriter();
JsonWriter writer = new JsonWriter(sw);
new JsonSerializer().Serialize(writer, webInfo);
string json = sw.GetStringBuilder().ToString();

輸出對應的 JSON 結果

{"webname":"FoxDevelop","website":"foxdevelop.com","age":4,"students":[{"name":"張三"},{"name":"李四"}]}

反序列化

把 JSON 字串還原為實體物件

寫法一（底層 Reader 實作）

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

寫法二（簡潔泛型，Newtonsoft.Json）

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

new JsonSerializer().Deserialize(new JsonTextReader(new StringReader(jsonString)), typeof(類別名稱) as 類別名稱

透過以上方式，就可以把 JSON 物件反序列化成實體物件。

也可以這樣寫

JavaScriptConvert.DeserializeObject<NodeInfo>(jsonText)

序列化與反序列化

Newtonsoft.Json（一般稱 Json.NET）是 .NET 生態的開源 JSON 序列化與反序列化元件

• 2006 釋出第一版 Json.NET 1.0.1，目前主流版本已更新至 10+
• 最初相容 .NET 2.0，幾乎支援全部 .NET 框架（Framework/.NET Core/.NET 5+）
• 組件檔：Newtonsoft.Json.dll，透過 NuGet 安裝使用
• 早期原始碼託管在 CodePlex，現已移轉至 GitHub，大量企業專案都在使用

2. JSON 是什麼

JSON（JavaScript Object Notation，JS物件標記）

• 輕量級、與程式語言無關的資料交換文字格式，並非 JavaScript 專用
• 核心結構：鍵值對 key:value；支援物件 {}、陣列 [] 巢狀寫法

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

二、實體類別定義（對應JSON結構）

Person.cs（學生物件）

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

WebInfo.cs（外層主物件）

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

範例‑物件序列化為JSON

protected void Page_Load(object sender, EventArgs e)
{
    // 1. 建立實體物件並設定屬性
    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 底層寫法：使用JsonWriter做序列化
    StringWriter sw = new StringWriter();
    JsonWriter writer = new JsonWriter(sw);
    new JsonSerializer().Serialize(writer, webInfo);
    string json = sw.GetStringBuilder().ToString();
}

日常開發的簡化寫法

Newtonsoft.Json 提供靜態工具方法，不用手動建立 JsonWriter：

// 一行完成序列化，開發最常使用
string json = JsonConvert.SerializeObject(webInfo);

輸出JSON結果

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

其他

• System.Text.Json：.NET Core 3.0 之後微軟內建的JSON函式庫；舊版 .NET Framework 專案大多還是使用 Newtonsoft.Json
• 功能：支援屬性別名、欄位忽略、日期格式化、迴圈參考處理等高級功能

介紹