1. Lembrando JSON
JSON significa JavaScript Object Notation. Apesar da palavra meio assustadora JavaScript no nome, esse formato é totalmente linguagem-neutro e amigável para todo mundo (bem, quase todo mundo) que programa, incluindo C#. Foi criado para descrever dados de forma clara e conveniente — objetos, arrays, listas e dicionários — como texto simples.
No mundo moderno, onde quase todo programa troca dados com outros programas, JSON virou praticamente um padrão de fato para serialização e troca de dados estruturados. Ele é usado em todo lugar: de REST API até armazenamento de configurações do usuário e até para comunicação interna entre microservices. E por um bom motivo — é legível por humanos (se o humano não tiver pavor de chaves {}), fácil de parsear e suportado por todas as linguagens e bibliotecas modernas.
Por que não XML?
JSON é mais simples, mais curto e mais fácil de ler que XML. Além disso, ele tem menos ruído e tags, e faz mais sentido para as estruturas de dados da maioria das linguagens. E não precisa se preocupar com tags de fechamento, aspas e toda aquela burocracia do XML. Em resumo — JSON é sobre mais rápido, mais simples, mais conveniente.
2. Elementos principais da sintaxe JSON
Pense no JSON como uma árvore simples (ou uma matrioska) composta de objetos, arrays e dados primitivos. Aqui estão os "tijolinhos" que temos:
Objetos (Objects)
Objeto JSON é um conjunto de pares "chave: valor", delimitado por chaves { }.
Exemplo:
{
"name": "Alice",
"age": 23
}
Em C# essa estrutura pode ser representada por uma classe ou um dicionário.
Arrays (Arrays)
Array JSON é uma lista ordenada de elementos (valores de qualquer tipo), envolta por colchetes [ ].
Exemplo:
[1, 2, 3, 42]
Ou assim:
[
{"name": "Ivan"},
{"name": "Olga"}
]
Em C# — isso vira List<T>, T[] e coleções similares.
Paresh "chave-valor"
As chaves são sempre strings (entre aspas duplas!), e os valores podem ser qualquer um dos tipos permitidos no JSON.
Exemplo:
{
"id": 123,
"login": "student",
"isActive": true
}
Tipos de dados no JSON
| Tipo JSON | Exemplo | Descrição |
|---|---|---|
| Número (Number) | |
Inteiro ou float |
| String (String) | |
Sempre entre aspas duplas |
| Booleano (Boolean) | |
Valor lógico |
| null | |
Ausência de valor |
| Objeto (Object) | |
Dicionário ou entidade com campos |
| Array (Array) | |
Sequência de valores |
Exemplo — tudo junto:
{
"id": 1,
"name": "Bob",
"scores": [10, 20, 30],
"profile": {
"email": "bob@mail.com",
"phone": null
},
"isAdmin": false
}
Viu como dá pra descrever um objeto de usuário de forma compacta e lógica?
3. Regras de formatação do JSON
Strings sempre entre aspas duplas
Mesmo que dê vontade de usar aspas simples, JSON não permite. Assim — certo:
{ "name": "Vera" }
Assim — erro:
{ 'name': 'Vera' }
Chaves — apenas strings
Ao contrário do C#, onde a chave de um dicionário pode ser um int ou um enum, no JSON a chave é sempre uma string:
{ "2025": "God C#", "favorite": true }
Sem vírgulas finais
Ao contrário de listas/objetos em C#, uma vírgula extra antes da chave de fechamento é erro de sintaxe no JSON!
// ERRO! (vírgula no final não é permitida)
{
"id": 10,
"name": "Oleg",
}
Certo:
{
"id": 10,
"name": "Oleg"
}
Espaços e quebras de linha
Você pode usar para ficar bonito — os parsers ignoram. Normalmente se usa pretty-printed (formatado) para visualização humana e minified (tudo em uma linha, sem espaços) para transferência pela rede.
4. Como objetos C# viram JSON
Se você serializar um objeto com System.Text.Json.JsonSerializer.Serialize(), os campos e propriedades viram pares "chave-valor".
Exemplo de classe C# e serialização
public class Book
{
public string Title { get; set; }
public int Pages { get; set; }
}
var book = new Book { Title = "CLR via C#", Pages = 900 };
string json = JsonSerializer.Serialize(book);
Console.WriteLine(json); // {"Title":"CLR via C#","Pages":900}
Collections
- List<int> vira [1,2,3]
- string[] vira ["hi", "wow"]
- List<Person> — vira um array de objetos
Dicionários
Um dicionário do tipo Dictionary<string, int> vira um objeto:
var dict = new Dictionary<string, int>
{
["apples"] = 5, ["bananas"] = 10
};
string json = JsonSerializer.Serialize(dict);
// {"apples":5,"bananas":10}
5. Esquema visual: como o JSON é construído
Nivelamento — tipo matrioska
Objeto
│
├── Par: "name": "Alex"
├── Par: "hobbies": array
│ │
│ ├── "skiing"
│ └── "programming"
└── Par: "profile": objeto
│
├── "age": 42
└── "city": "Bazel"
Como resultado:
{
"name": "Alex",
"hobbies": ["skiing", "programming"],
"profile": {
"age": 42,
"city": "Bazel"
}
}
6. Erros típicos e peculariedades de sintaxe
No mundo da programação não existe perfeição — até no JSON tem pegadinhas! Se você tentar enviar JSON com aspas erradas, vírgulas extras ou chaves sem aspas — o parser vai falhar.
Outra armadilha — números com zeros à esquerda. No JSON isso é proibido (por exemplo, 0123 — é erro).
É útil saber: Alguns parsers (por exemplo o JavaScript JSON.parse) são mais permissivos e podem "perdoar" pequenas violações. Mas a maioria dos parsers "rígidos" (por exemplo no C# e .NET) vai reclamar pelo menor erro de sintaxe.
7. Exemplos de conversão de dados C# para JSON
Vamos serializar uma estrutura mais complexa na prática. Nosso app de estudo evoluiu: digamos que agora temos uma lista de estudantes e queremos salvar no arquivo JSON.
Definimos a classe:
public class Student
{
public string Name { get; set; }
public int Age { get; set; }
}
Preenchemos a lista:
var students = new List<Student>
{
new Student { Name = "Anna", Age = 20 },
new Student { Name = "Nikita", Age = 22 }
};
Serialização:
using System.Text.Json;
// Serializamos a lista de students para uma string JSON
string json = JsonSerializer.Serialize(students, new JsonSerializerOptions { WriteIndented = true });
Console.WriteLine(json);
/*
[
{
"Name": "Anna",
"Age": 20
},
{
"Name": "Nikita",
"Age": 22
}
]
*/
Percebe como fica prático? Cada estudante é um objeto separado dentro do array JSON.
8. Mini-gerador: como escrever JSON "na mão"
Às vezes você precisa escrever JSON manualmente, por exemplo para criar dados de teste. Aqui vai um checklist:
- Chaves externas { } — para objeto, colchetes externos [ ] — para array.
- Chave sempre — string entre aspas duplas.
- Valores — strings (entre aspas duplas), números, true, false, null, objeto ({}), array ([]).
- Somente vírgulas entre elementos, não depois do último!
- Indentação e espaços para legibilidade (mas não obrigatórios).
GO TO FULL VERSION