CodeGym /Cursos /C# SELF /Noções básicas de sintaxe e estrutura JSON

Noções básicas de sintaxe e estrutura JSON

C# SELF
Nível 47, Lição 0
Disponível

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)
10, -5, 3.14
Inteiro ou float
String (String)
"hello"
Sempre entre aspas duplas
Booleano (Boolean)
true, false
Valor lógico
null
null
Ausência de valor
Objeto (Object)
{"a":1}
Dicionário ou entidade com campos
Array (Array)
[1,2,3]
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:

  1. Chaves externas { } — para objeto, colchetes externos [ ] — para array.
  2. Chave sempre — string entre aspas duplas.
  3. Valores — strings (entre aspas duplas), números, true, false, null, objeto ({}), array ([]).
  4. Somente vírgulas entre elementos, não depois do último!
  5. Indentação e espaços para legibilidade (mas não obrigatórios).
2
Tarefa
C# SELF, nível 47, lição 0
Bloqueado
Serialização de uma lista de objetos em JSON
Serialização de uma lista de objetos em JSON
Comentários
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION