Guida pratica

Generatore di classi C# da JSON — Guida all’uso e principi tecnici

Converte payload JSON in classi C# fortemente tipizzate con attributi JsonPropertyName, supporto nullable e codice pulito.

Apri lo strumento

Panoramica

Applicazioni .NET consumano JSON ovunque: API REST, eventi cloud, configurazioni, telemetria e code. Generare classi C# tipizzate garantisce sicurezza di compilazione, IntelliSense migliore e refactor più sicuri. JsonPropertyName mantiene le chiavi originali e accelera la condivisione dei contratti tra i team.

Concetti chiave

Mapping JSON → C#

Le stringhe diventano string o DateTime, gli interi long, i valori decimali double, i booleani bool, gli oggetti classi dedicate e gli array List<T>. Se l’esempio contiene null, la proprietà diventa nullable e, se l’opzione è attiva, viene aggiunto ?. Gli array misti vengono convertiti in List<object> per non perdere informazioni.

Pipeline di generazione

Il convertitore attraversa il JSON in modo ricorsivo, normalizza i nomi in PascalCase ed evita le parole riservate C#. Forme identiche condividono la stessa classe e gli array riutilizzano il tipo inferito. Dopo la conversione, una dashboard mostra il numero di classi, proprietà e array per valutare la complessità.

JsonPropertyName e serializzazione

System.Text.Json si basa su JsonPropertyName, quindi l’output può decorare ogni proprietà con la chiave originale per gestire payload snake_case. Poiché le classi sono partial, puoi aggiungere validazioni o converter personalizzati in altri file senza toccare il codice generato.

Strategia nullable

Con i riferimenti nullable abilitati, tutti i valori che possono essere null (bool, long, double, string, List<T>, classi annidate) ricevono automaticamente ?. In questo modo il compilatore segnala subito gli accessi rischiosi e riduci le NullReferenceException.

Caratteristiche

Output fortemente tipizzato

Deduce tipi C#, genera classi annidate e mantiene le chiavi originali del JSON.

JsonPropertyName

Garantisce la piena compatibilità con System.Text.Json anche per payload snake_case.

Consapevolezza nullable

Aggiunge ? quando un campo può essere null, documentando chiaramente i contratti opzionali.

Statistiche integrate

Mostra quante classi, proprietà e array sono stati creati.

Domande frequenti

Cos'è la generazione di classi C# da JSON e perché è utile?

La generazione di classi C# da JSON crea automaticamente classi C# fortemente tipizzate da strutture di dati JSON. Questo è essenziale quando si lavora con API, file di configurazione o serializzazione dei dati in applicazioni .NET. Invece di scrivere classi manualmente o usare tipi dinamici, il generatore crea classi C# appropriate con tipi corretti, supporto nullable e attributi JsonPropertyName, risparmiando ore di sviluppo e riducendo errori.

Come gestisce il generatore diversi tipi di dati JSON?

Il generatore mappa i tipi JSON a tipi C# appropriati: le stringhe diventano string o DateTime (per date ISO-8601), gli interi mappano a long, i numeri a virgola mobile a double, i booleani a bool, gli oggetti diventano classi dedicate e gli array diventano List<T>. I valori null segnano le proprietà come nullable (con suffisso ? quando i riferimenti nullable sono abilitati). Gli array misti usano List<object> per preservare dati eterogenei.

Cosa sono gli attributi JsonPropertyName e quando dovrei usarli?

Gli attributi JsonPropertyName permettono alle proprietà C# di usare la nomenclatura PascalCase (convenzione C#) mentre JSON usa una nomenclatura diversa (come snake_case o camelCase). L'attributo preserva il nome della chiave JSON originale durante la serializzazione/deserializzazione. Abilita questa opzione quando il tuo JSON usa chiavi non-PascalCase ma vuoi nomi di proprietà C# idiomatici nel tuo codice.

Cos'è il supporto per riferimenti nullable e perché abilitarlo?

I tipi di riferimento nullable (C# 8.0+) aggiungono ? ai tipi di riferimento quando possono essere null, abilitando il controllo null in fase di compilazione. Quando abilitato, il generatore aggiunge ? alle proprietà quando il campione JSON contiene valori null. Questo aiuta a prevenire errori NullReferenceException, rende i campi opzionali espliciti e segue le migliori pratiche moderne di C# per la sicurezza null.

Posso modificare le classi generate dopo la generazione?

Sì, il generatore crea classi parziali per impostazione predefinita (o quando abilitato), permettendoti di estenderle in file separati senza modificare il codice generato. Puoi aggiungere metodi personalizzati, logica di validazione, attributi specifici del dominio o implementare interfacce. Questa separazione mantiene il codice generato pulito e permette di rigenerare in sicurezza le classi quando la struttura JSON cambia.

Documentazione correlata

Generatore di classi C# da JSON

Apri lo strumento per provare queste funzionalità.

Apri lo strumento