- 什麼是 JSON 到 C# 類別產生,為什麼它有用?
- JSON 到 C# 類別產生可以從 JSON 資料結構自動建立強型別 C# 類別。這在處理 .NET 應用程式中的 API、設定檔或資料序列化時至關重要。產生器建立具有正確型別、可空支援和 JsonPropertyName 屬性的適當 C# 類別,而不是手動編寫類別或使用動態型別,從而節省數小時的開發時間並減少錯誤。
- 產生器如何處理不同的 JSON 資料型別?
- 產生器將 JSON 型別對應到適當的 C# 型別:字串變為 字串 或 DateTime(對於 ISO-8601 日期),整數對應到 long,浮點數對應到 double,布林值對應到 bool,物件變為專用類別,陣列變為 清單<T>。空值將屬性標記為可空(啟用可空引用時帶有 ? 後綴)。混合陣列使用 清單<object> 來保留異構資料。
- 什麼是 JsonPropertyName 屬性,何時應該使用它們?
- JsonPropertyName 屬性允許 C# 屬性使用 PascalCase 命名(C# 慣例),而 JSON 使用不同的命名(如 snake_case 或 camelCase)。該屬性在序列化/反序列化期間保留原始 JSON 鍵名。當您的 JSON 使用非 PascalCase 鍵但您希望在程式碼中使用慣用的 C# 屬性名時,請啟用此選項。
- 什麼是可空引用支援,為什麼要啟用它?
- 可空引用型別(C# 8.0+)在引用型別可以為 null 時新增 ?,啟用編譯時 null 檢查。啟用後,當 JSON 樣本包含 null 值時,產生器會在屬性後附加 ?。這有助於防止 NullReferenceException 錯誤,使可選欄位顯式,並遵循現代 C# 的 null 安全最佳實踐。
- 產生後我可以修改產生的類別嗎?
- 可以,產生器預設建立部分類別(或啟用時),允許您在單獨的檔案中擴展它們而無需修改產生的程式碼。您可以新增自訂方法、驗證邏輯、特定領域的屬性或實作介面。這種分離保持產生的程式碼整潔,並在 JSON 結構變更時安全地重新產生類別。