Convierta una muestra JSON en clases o records de C# para System.Text.Json o Newtonsoft.Json
Se ejecuta en su navegador. Nada de lo que escribe se envía a ningún sitio. Comprobado el 16 de octubre de 2026.Pegue una muestra JSON y obtenga clases o records de C# con propiedades en PascalCase y la clave JSON en un atributo JsonPropertyName o JsonProperty. Los números enteros pasan a int, a long por encima de 2,147,483,647, cualquier decimal convierte el campo en double, y un valor null o ausente pasa a ser anulable, como int?.
Esta página se ha traducido automáticamente del original en inglés. Ninguna persona ha revisado todavía la traducción, así que la versión en inglés es la que debe consultar. Leer el original en inglés
Pegue una muestra JSON, por ejemplo la respuesta de una API, en el cuadro de la izquierda.
Las clases C# aparecen mientras escribe, una por objeto, con propiedades en PascalCase y la clave JSON en un atributo en cada una.
Elija System.Text.Json o Newtonsoft.Json, y records con init si prefiere modelos inmutables.
Pulse Copiar, o Descargar para guardar Models.cs, y deserialice en la clase raíz.
C# lee JSON en clases tipadas, y cada propiedad necesita el tipo correcto y una forma de encontrar su clave. Este convertidor escribe esas clases a partir de una muestra, así que una respuesta de API larga se convierte en un modelo que compila con un solo pegado.
Cómo se eligen los tipos.
| Valor JSON | Tipo C# |
|---|---|
| "text" | string |
| true / false | bool |
| 42 (solo números enteros) | int, o long más allá de 32 bits |
| 4.5 (si aparece algún decimal) | double |
| null, y además un tipo | int?, string? |
| solo null, o tipos mezclados | object? |
| [ ... ] | List<...> |
| { } vacío | Dictionary<string, object> |
| { ... } | una clase propia |
Claves y nombres. Las propiedades van en PascalCase, así que user_name pasa a UserName y avatar_url a AvatarUrl. Cada propiedad lleva su clave original en un atributo, porque System.Text.Json compara los nombres distinguiendo mayúsculas salvo que se le indique lo contrario; Newtonsoft recibe [JsonProperty] en su lugar. Una propiedad que compartiría el nombre de su clase, algo que el compilador rechaza como CS0542, recibe Value añadido.
Arrays de objetos. Todos los objetos de un array se fusionan en una clase, así que una clave que aparece solo en algunos sigue estando, como anulable, para que su ausencia se lea como null y no como 0 o false. Dos objetos con exactamente las mismas claves y tipos comparten una clase.
Opciones. Los records con init dan modelos inmutables que se comparan por valor. La clase raíz se llama Root salvo que le ponga otro nombre. Cuando el propio JSON es un array o un valor suelto, un comentario indica en qué tipo deserializar, como List.
Cada resultado se comprobó leyendo de nuevo el C# y cotejando 9 muestras con él según las reglas de los serializadores. Nada de lo que pegue sale del navegador.
Pegue una muestra JSON en el convertidor y las clases C# aparecen al lado, una por objeto, con un atributo JsonPropertyName en cada propiedad. Cópielas en su proyecto y lea el JSON con JsonSerializer.Deserialize<Root>(json), o con JsonConvert.DeserializeObject<Root>(json) cuando elige Newtonsoft.
System.Text.Json compara por defecto los nombres de propiedad distinguiendo mayúsculas, así que una propiedad llamada UserName nunca recibiría la clave user_name. El atributo nombra la clave exacta, lo que mantiene los nombres de C# en PascalCase y sigue leyendo el JSON sin opciones del serializador ni política de nombres.
Una propiedad es anulable cuando la muestra tiene null en ella, o cuando algunos objetos de un array omiten su clave. Sin el signo de interrogación, un número ausente se leería en silencio como 0 y un indicador ausente como false, así que el tipo anulable distingue ausente de cero.
Los records con accesores init sirven para modelos que solo lee, porque sus propiedades no pueden cambiar tras la deserialización y dos records con los mismos valores son iguales. Las clases con set sirven para modelos que rellena o edita. Ambos funcionan con System.Text.Json desde .NET 5 y con Newtonsoft.Json.
Los números enteros pasan a int, o a long cuando un valor supera 2,147,483,647, y un campo pasa a double en cuanto algún valor de la muestra tiene parte decimal. Los valores de tipos distintos, como un número en un elemento y texto en otro, pasan a object?, que conserva el valor JSON tal cual.
No. La conversión se hace en su navegador sin ninguna petición a un servidor, y el JSON no se guarda, así que las respuestas de API con tokens o datos personales se quedan en su dispositivo. Cierre la pestaña y no queda nada.
Los tipos y las normas cambian; consulte la fuente antes de fiarse de una cifra.
¿Sigue sin resolverlo? Pregunte sobre Convertidor de JSON a clases C# y cualquiera que lo sepa puede responder. No se necesita cuenta.