JSON para C#
Gere classes C# para System.Text.Json a partir de um exemplo de JSON. Cada propriedade recebe um atributo JsonPropertyName com a chave original e um nome em PascalCase; as chaves presentes em todos os exemplos são marcadas como obrigatórias, valores anuláveis e opcionais usam tipos anuláveis, e arrays passam a ser List. Valores de tipos mistos passam a ser JsonElement.
Perguntas frequentes
Como os objetos aninhados são nomeados?
Cada objeto aninhado se torna seu próprio tipo C#, nomeado com base na chave que o contém em PascalCase; assim, address passa a ser Address. Objetos dentro de arrays usam o singular da chave do array; assim, users passa a ser User. Objetos com exatamente os mesmos campos compartilham um tipo.
Quando um campo é opcional?
Quando um array contém vários objetos e uma chave está ausente em alguns deles, esse campo é opcional: não tem o modificador required e seu tipo passa a ser anulável. Uma chave presente em todos os exemplos é obrigatória. Um único objeto não tem com o que ser comparado, então todas as suas chaves são obrigatórias.
Como os valores nulos são tratados?
Uma chave que é null em alguns exemplos e tem um valor em outros passa a ser de um tipo anulável, como string?. Uma chave que é sempre null não informa à ferramenta qual é seu tipo real, então ela passa a ser JsonElement?; cole um exemplo com um valor real para obter um tipo preciso.
Quais tipos numéricos são usados?
Números inteiros passam a ser long, e números com frações passam a ser double. Um campo que contém ambos passa a ser double.
O que acontece com chaves que não são nomes válidos?
Os nomes das propriedades são reconstruídos em PascalCase, e o atributo JsonPropertyName mantém a chave original; assim, first-name passa a ser FirstName e continua lendo first-name. Uma propriedade que teria o mesmo nome da classe recebe um número ao final, pois C# não permite isso.
Meu JSON é enviado ou armazenado?
O JSON é enviado ao servidor apenas para gerar o código desta solicitação e não é armazenado. O gerador lê somente a estrutura e os tipos de valor da sua amostra; por isso, você pode substituir valores confidenciais por marcadores do mesmo tipo antes de colá-la.