Guia prático

Gerador de classes C# a partir de JSON — Guia de uso e princípios técnicos

Transforme payloads JSON em classes C# fortemente tipadas com JsonPropertyName, suporte a referências anuláveis e código limpo pronto para uso.

Abrir ferramenta

Visão geral

APIs REST, eventos em nuvem, configurações e telemetria entregam JSON. Conversor esses exemplos em classes C# tipadas garante segurança em tempo de compilação, melhor IntelliSense, modelos de domínio claros e refatorações tranquilas. JsonPropertyName preserva as chaves originais e acelera a troca de contratos entre equipes.

Conceitos principais

Mapeamento JSON → C#

Strings tornam-se string ou DateTime, inteiros viram long, números com decimais double, booleanos bool, objetos classes dedicadas e arrays viram List<T>. Se o exemplo contém null, a propriedade vira nullable e, com a opção ativada, recebe ?. Arrays heterogêneos recuam para List<object> preservando toda a estrutura.

Pipeline de geração

O conversor percorre o JSON recursivamente, normaliza nomes para PascalCase, evita palavras reservadas e reutiliza assinaturas quando os objetos possuem o mesmo formato. As métricas de classes, propriedades e arrays são exibidas imediatamente após a conversão para avaliar a complexidade do payload.

JsonPropertyName e serialização

System.Text.Json utiliza JsonPropertyName, portanto o código pode ser decorado com a chave original, garantindo compatibilidade com payloads snake_case. Como as classes são partial, você pode adicionar validações, conversores ou anotações em outros arquivos sem tocar no código gerado.

Estratégia nullable

Referências anuláveis ativadas significam que todo valor potencialmente null (bool, long, double, string, List<T>, classes aninhadas) recebe ?. Assim o compilador alerta cedo e NullReferenceException são evitadas.

Recursos

Saída tipada

Infere tipos C#, cria classes aninhadas e preserva as chaves originais do JSON.

JsonPropertyName

Garante compatibilidade total com System.Text.Json mesmo para payloads snake_case.

Consciência nullable

Adiciona ? automaticamente quando o campo pode ser null e documenta claramente o contrato.

Estatísticas integradas

Mostra quantas classes, propriedades e arrays foram gerados.

Perguntas frequentes

O que é geração de classes C# a partir de JSON e por que é útil?

A geração de classes C# a partir de JSON cria automaticamente classes C# fortemente tipadas a partir de estruturas de dados JSON. Isso é essencial ao trabalhar com APIs, arquivos de configuração ou serialização de dados em aplicações .NET. Em vez de escrever classes manualmente ou usar tipos dinâmicos, o gerador cria classes C# apropriadas com tipos corretos, suporte nullable e atributos JsonPropertyName, economizando horas de desenvolvimento e reduzindo erros.

Como o gerador lida com diferentes tipos de dados JSON?

O gerador mapeia tipos JSON para tipos C# apropriados: strings se tornam string ou DateTime (para datas ISO-8601), inteiros mapeiam para long, números de ponto flutuante para double, booleanos para bool, objetos se tornam classes dedicadas e arrays se tornam List<T>. Valores null marcam propriedades como nullable (com sufixo ? quando referências nullable estão habilitadas). Arrays mistos usam List<object> para preservar dados heterogêneos.

O que são atributos JsonPropertyName e quando devo usá-los?

Atributos JsonPropertyName permitem que propriedades C# usem nomenclatura PascalCase (convenção C#) enquanto JSON usa nomenclatura diferente (como snake_case ou camelCase). O atributo preserva o nome da chave JSON original durante serialização/desserialização. Habilite esta opção quando seu JSON usa chaves não-PascalCase mas você quer nomes de propriedades C# idiomáticos em seu código.

O que é suporte de referências nullable e por que habilitá-lo?

Tipos de referência nullable (C# 8.0+) adicionam ? a tipos de referência quando podem ser null, habilitando verificação null em tempo de compilação. Quando habilitado, o gerador adiciona ? a propriedades quando a amostra JSON contém valores null. Isso ajuda a prevenir erros NullReferenceException, torna campos opcionais explícitos e segue melhores práticas modernas de C# para segurança null.

Posso modificar as classes geradas após a geração?

Sim, o gerador cria classes parciais por padrão (ou quando habilitado), permitindo que você as estenda em arquivos separados sem modificar o código gerado. Você pode adicionar métodos personalizados, lógica de validação, atributos específicos do domínio ou implementar interfaces. Esta separação mantém o código gerado limpo e permite regenerar com segurança as classes quando a estrutura JSON muda.

Documentação relacionada

Gerador de classes C# a partir de JSON

Abra a ferramenta para experimentar estes recursos.

Abrir ferramenta