Guía práctica

Generador de clases C# desde JSON — Guía de uso y principios técnicos

Convierte payloads JSON en clases C# fuertemente tipadas con atributos JsonPropertyName, soporte nullable y código limpio listo para usar.

Abrir herramienta

Resumen

Las aplicaciones .NET consumen JSON en todas partes: APIs REST, eventos cloud, configuración, telemetría y colas. Generar clases C# tipadas proporciona seguridad en compilación, mejor IntelliSense, modelos de dominio claros y refactors seguros. JsonPropertyName conserva las claves originales y agiliza los contratos entre equipos.

Conceptos clave

Mapeo JSON → C#

Las cadenas se transforman en string o DateTime, los enteros en long, los decimales en double, los booleanos en bool, los objetos en clases dedicadas y los arreglos en Liste<T>. Cuando el ejemplo incluye null, la propiedad se marca como nullable y, si la opción está activa, se añade ?. Los arreglos heterogéneos se degradan a Liste<object> para mantener la estructura completa.

Canal de generación

El analizador recorre el JSON de forma recursiva, construye firmas reutilizables y normaliza los nombres a PascalCase evitando palabras reservadas de C#. Las formas idénticas reutilizan la misma clase y los arreglos comparten el tipo inferido. Tras la conversión se muestran las métricas de clases, propiedades y arreglos para estimar la complejidad del modelo.

JsonPropertyName y serialización

System.Text.Json respeta JsonPropertyName, de modo que las cargas snake_case pueden consumirse desde propiedades PascalCase. Las clases se generan como partial, por lo que puede añadir validaciones, convertidores o anotaciones propias en archivos separados sin modificar el código generado.

Estrategia nullable

Al activar las referencias nullables, cualquier valor que pueda ser null (bool, long, double, string, Liste<T>, clases anidadas…) recibe un ?. Esto traslada los avisos al compilador y reduce drásticamente las NullReferenceException en producción.

Funciones

Salida tipada

Infiera tipos C#, genere clases anidadas y respete PascalCase sin perder las claves originales.

JsonPropertyName

Mantenga la compatibilidad con System.Text.Json para payloads snake_case gracias a los atributos JsonPropertyName.

Conciencia nullable

Cuando detecta null agrega ? automáticamente y documenta qué campos son opcionales.

Estadísticas integradas

Clases, propiedades y arreglos contados al instante para entender la complejidad.

Preguntas frecuentes

¿Qué es la generación de clases C# desde JSON y por qué es útil?

La generación de clases C# desde JSON crea automáticamente clases C# fuertemente tipadas desde estructuras de datos JSON. Esto es esencial al trabajar con APIs, archivos de configuración o serialización de datos en aplicaciones .NET. En lugar de escribir clases manualmente o usar tipos dinámicos, el generador crea clases C# apropiadas con tipos correctos, soporte nullable y atributos JsonPropertyName, ahorrando horas de desarrollo y reduciendo errores.

¿Cómo maneja el generador diferentes tipos de datos JSON?

El generador mapea tipos JSON a tipos C# apropiados: las cadenas se convierten en string o DateTime (para fechas ISO-8601), los enteros se mapean a long, los números de punto flotante a double, los booleanos a bool, los objetos se convierten en clases dedicadas y los arrays se convierten en Liste<T>. Los valores null marcan propiedades como nullable (con sufijo ? cuando las referencias nullable están habilitadas). Los arrays mixtos usan Liste<object> para preservar datos heterogéneos.

¿Qué son los atributos JsonPropertyName y cuándo debo usarlos?

Los atributos JsonPropertyName permiten que las propiedades C# usen nomenclatura PascalCase (convención C#) mientras que JSON usa nomenclatura diferente (como snake_case o camelCase). El atributo preserva el nombre de clave JSON original durante serialización/deserialización. Habilita esta opción cuando tu JSON usa claves Non-PascalCase pero quieres nombres de propiedades C# idiomáticos en tu código.

¿Qué es el soporte de referencias nullable y por qué habilitarlo?

Los tipos de referencia nullable (C# 8.0+) agregan ? a tipos de referencia cuando pueden ser null, habilitando verificación null en tiempo de compilación. Cuando está habilitado, el generador agrega ? a propiedades cuando la muestra JSON contiene valores null. Esto ayuda a prevenir errores NullReferenceException, hace campos opcionales explícitos y sigue mejores prácticas modernas de C# para seguridad null.

¿Puedo modificar las clases generadas después de la generación?

Sí, el generador crea clases parciales por defecto (o cuando está habilitado), permitiéndote extenderlas en archivos separados sin modificar el código generado. Puedes agregar métodos personalizados, lógica de validación, atributos específicos del dominio o implementar interfaces. Esta separación mantiene el código generado limpio y permite regenerar de forma segura las clases cuando la estructura JSON cambia.

Documentación relacionada

Generador de clases C# desde JSON

Abre la herramienta para probar estas funciones.

Abrir herramienta