1. Introdução
O PDF do documento está AQUI.
O código deste documento está AQUI.
Este documento é um produto de Claude, a IA da Anthropic. Trata-se de uma reescrita, para o C# 14 e a plataforma .NET 10, do curso “Apprentissage de C# version 3.0 avec le framework .NET 3.5”, escrito por Serge Tahé em maio de 2008. Ele mantém o roteiro, os exemplos e o tema central do curso, atualizando a linguagem, as bibliotecas e as ferramentas:
- o curso de 2008 usava o C# 3.0 e o .NET Framework 3.5 no Windows, com o Visual C# 2008 Express. Desde então, o C# teve onze versões principais (do C# 4.0, em 2010, ao C# 14, em 2025), e a plataforma .NET foi completamente reescrita: agora é de código aberto, multiplataforma (Windows, Linux, macOS) e lançada anualmente. Este documento usa o .NET 10 (novembro de 2025, versão de suporte de longo prazo) e o C# 14;
- o capítulo sobre interfaces gráficas Windows Forms foi removido: hoje, os aplicativos corporativos costumam ser escritos com interfaces web. O capítulo “Eventos do usuário”, que vinha em seguida, foi reformulado como um capítulo sobre delegates, expressões lambda e eventos, sem formulários;
- Dois capítulos são novos: programação assíncrona ([Task] tarefas e o par [async] / [await], introduzido em 2012 com o C# 5) e Entity Framework Core, a ferramenta de mapeamento objeto-relacional do .NET. O capítulo sobre as classes do .NET de uso frequente agora abrange LINQ (o curso de 2008 afirmava explicitamente que não tratava do assunto);
- as ferramentas mudaram: o [VS Code] editor (ou a IDE [Visual Studio 2026]) e o comando [dotnet] substituem o Visual C# 2008 Express; o framework de testes [MSTest] substitui o [NUnit 2]; a injeção de dependência fornecida por [Microsoft.Extensions.DependencyInjection] substitui o [Spring.NET]; o SGBD [MySQL] (fornecido pelo [Laragon]) e o conector [MySqlConnector] substituem o SQL Server 2005 Express; a classe [HttpClient] substitui [WebClient] e [WebRequest], que foram descontinuadas; os serviços web REST / JSON escritos com ASP.NET Core substituem os serviços web SOAP e [ASMX];
- tudo o que se tornou obsoleto foi removido ou assinalado como tal, e cada capítulo apresenta os recursos mais recentes da linguagem e da plataforma na data da redação.
Este documento não é um curso exaustivo. Como a edição de 2008, destina-se a leitores que já têm experiência de programação e querem aprender o essencial do C#. Ele se baseia em exemplos: mais de duzentos programas (quase trezentos arquivos C#), a maioria curtos, com comentários linha por linha.
1.1. C# e .NET de 2002 a 2026
O C# foi lançado em fevereiro de 2002, junto com a plataforma .NET 1.0 da Microsoft, à qual está ligado. A plataforma .NET é um ambiente de execução semelhante à máquina virtual Java: os compiladores das linguagens .NET (C#, F#, VB.NET) geram um código intermediário (IL, “Intermediate Language”) que a máquina virtual .NET (o CLR, “Common Language Runtime”) compila dinamicamente em código de máquina. Todas as classes da plataforma estão disponíveis para todas as linguagens .NET.
Em 2008, o curso afirmava que o .NET só funcionava no Windows e que o projeto Mono permitia usá-lo, de forma limitada, no Unix e no Linux. A situação mudou bastante:
- 2016: .NET Core 1.0. A Microsoft lançou uma nova implementação do .NET, de código aberto (licença MIT, código disponível no GitHub) e multiplataforma: Windows, Linux e macOS. O antigo framework “.NET” (.NET Framework 4.x) continua com suporte para aplicativos Windows legados, mas não evolui mais;
- 2020: .NET 5. O .NET Core passa a se chamar simplesmente “.NET”: uma única plataforma para todos os usos (console, web, desktop, mobile, nuvem);
- Desde 2020: uma nova versão do .NET é lançada todo ano, em novembro. As versões de número par (.NET 6, 8, 10) têm suporte estendido (LTS, três anos); as versões de número ímpar (.NET 7, 9) têm suporte padrão (STS: dezoito meses, estendido para dois anos a partir do .NET 9). Cada versão do .NET traz uma nova versão do C#;
- Novembro de 2025: .NET 10 (LTS) e C# 14, que são os usados neste documento. O .NET 10 tem suporte até novembro de 2028.
O curso de 2008 também observava que, em 2002, o C# era em grande parte uma cópia do Java e que era fácil passar de um para o outro, mas que as duas linguagens haviam desenvolvido desde então características próprias. A distância aumentou: ao longo de suas versões, o C# incorporou conceitos das linguagens funcionais (expressões lambda, LINQ, correspondência de padrões, records, tipos imutáveis), a programação assíncrona ([async] / [await], que JavaScript, Python e Rust adotaram depois) e um sistema de tipos que detecta referências nulas em tempo de compilação.
A tabela a seguir resume as principais novidades da linguagem desde o C# 3.0 e indica o capítulo deste documento em que são tratadas:
Versão | Ano | Principais novidades | Capítulo |
C# 4.0 | 2010 | parâmetros nomeados e opcionais (o tipo [dynamic] e a variância de genéricos, que também surgiram no C# 4, não são abordados) | 3 |
C# 5 | 2012 | métodos assíncronos [async] / [await] | 9 |
C# 6 | 2015 | strings interpoladas [$"..."], [nameof], operador [?.], filtros de exceção [when], membros com corpo de expressão | 3, 4 |
C# 7.0–7.3 | 2017–2018 | tuplas e desconstrução, [out var], funções locais, correspondência de padrões, literais binários e separadores [_], parâmetros [in] | 3, 4 |
C# 8 | 2019 | tipos de referência anuláveis, expressões [switch], índices [^1], e intervalos [1..3], [??=], declarações [using], métodos de interface padrão, fluxos assíncronos [await foreach] | 3 a 9 |
C# 9 | 2020 | instruções de nível superior, [record], propriedades [init], [new()] com tipo de destino, padrões relacionais e lógicos | 3, 4 |
C# 10 | 2021 | [global using], namespaces com escopo de arquivo, [record struct], tipo natural das lambdas | 3, 4, 7 |
C# 11 | 2022 | strings brutas ["""], membros [required], padrões de lista, membros estáticos abstratos de interface | 3, 4, 5, 12 |
C# 12 | 2023 | construtores primários, expressões de coleção [1, 2, 3], aliases para qualquer tipo, parâmetros padrão em lambdas | 3–7 |
C# 13 | 2024 | coleções [params], tipo [System.Threading.Lock] | 3, 8 |
C# 14 | 2025 | membros de extensão (blocos [extension]), [field] palavra-chave, [a?.B = x] atribuição condicional, operadores de atribuição composta definidos pelo usuário, parâmetros de lambda sem tipo com modificadores | 4, 7 |
No lado da plataforma, as novidades introduzidas incluem: o comando [dotnet] e os aplicativos de arquivo único (.NET 10), o formato de solução [.slnx], LINQ, coleções genéricas modernas, [System.Text.Json], expressões regulares geradas em tempo de compilação, injeção de dependência, tarefas e a biblioteca paralela, canais [Channel<T>], [HttpClient], ASP.NET Core e Entity Framework Core.
1.2. Conteúdo do documento
Este documento inclui os seguintes capítulos:
- Capítulo 2: configuração do ambiente de desenvolvimento (SDK do .NET 10, VS Code ou Visual Studio; o comando [dotnet]);
- Capítulo 3: fundamentos da linguagem (tipos, operadores, instruções de controle, exceções, enumerações, passagem de parâmetros, tuplas);
- Capítulo 4: classes, estruturas, interfaces, herança, genéricos, records, membros de extensão;
- Capítulo 5: classes do .NET de uso frequente: strings, arrays, coleções, LINQ, arquivos de texto e binários, JSON, expressões regulares;
- Capítulo 6: arquiteturas em camadas, testes unitários com MSTest e injeção de dependência;
- Capítulo 7: delegates, expressões lambda e eventos;
- Capítulo 8: threads de execução e sincronização;
- Capítulo 9: programação assíncrona;
- Capítulo 10: acesso a bancos de dados com ADO.NET;
- Capítulo 11: Entity Framework Core;
- Capítulo 12: programação web (TCP/IP, clientes e servidores TCP, HTTP com [HttpClient]);
- Capítulo 13: serviços web com ASP.NET Core;
- Capítulo 14: indo mais longe;
- Apêndices: instalação do Laragon e do MySQL.
1.3. O fio condutor: o cálculo do imposto
Como em 2008, o mesmo problema é retomado ao longo do documento: calcular o imposto de renda de um contribuinte que declara apenas o salário. A tabela de alíquotas usada é a do curso original (rendimentos de 2003): não está mais em vigor, mas basta para o nosso objetivo, que é escrever a mesma aplicação de várias maneiras diferentes. Ela é implementada em nove versões:
Versão | Capítulo | Conteúdo |
1 | 3 | Um único programa: entrada validada, cálculo, exibição |
2 | 4 | Classes e interfaces: [TaxBracket], [ITax], [AbstractTax], [HardwiredTax] |
3 | 5 | dados de cálculo lidos de um arquivo de texto ou de um arquivo JSON |
4 | 6 | Uma arquitetura em camadas ([dao], [business], [ui]) em um único projeto |
5 | 6 | Uma biblioteca por camada, testes unitários e integração das camadas por injeção de dependência |
6 | 10 | Uma camada [dao] que lê os dados de um banco de dados MySQL com ADO.NET |
7 | 11 | uma camada [dao] escrita com Entity Framework Core |
8 | 12 | Um servidor TCP de cálculo do imposto e seu cliente |
9 | 13 | um serviço web REST de cálculo do imposto, um cliente de console e um cliente web |
A partir da versão 5, as versões seguintes reutilizam as camadas da versão 5 e substituem apenas a camada que mudou: é justamente esse o objetivo da arquitetura em camadas apresentada no Capítulo 6.
1.4. Exemplos
O código deste documento está organizado em uma única pasta chamada [csharp-oct-2026], com uma subpasta por capítulo:
Os programas pequenos são aplicativos de arquivo único: um único arquivo chamado [.cs], executado pelo comando [dotnet run file.cs] (Capítulo 2). Os programas com vários arquivos são projetos ([.csproj]) agrupados em uma solução ([.slnx]) por capítulo.
Todos os programas deste documento foram compilados sem erros nem avisos com o SDK do .NET 10 e depois executados. Os resultados reproduzidos no documento são os dessas execuções. Os resultados do Capítulo 3 foram obtidos na localidade francesa (fr-FR), como em uma estação Windows francesa: os números reais são exibidos com vírgula decimal e as datas estão em francês. Os capítulos seguintes foram executados na localidade inglesa dos Estados Unidos (en-US): ponto decimal, vírgula como separador de milhares, datas no formato mês/dia/ano. Duas observações:
- as mensagens de erro da plataforma .NET (mensagens de exceção) estão em inglês: o .NET não oferece traduções para o francês dessas mensagens;
- os exemplos foram executados no Linux. Na maioria dos casos, isso não faz diferença: o .NET é multiplataforma. As poucas diferenças (caminhos de arquivo com / em vez de \, fins de linha) são indicadas onde ocorrem.
Os resultados de programas com várias threads, assíncronos ou de rede, assim como os tempos de execução medidos, podem variar de uma execução para outra: os comentários concentram-se no que é reproduzível.
1.5. Fontes
O curso de 2008 citava os livros que ajudaram em sua redação: “Professional C# Programming” (Wrox), “C# et .NET” de Gérard Leblanc (Eyrolles) e “C# 3.0 in a Nutshell” de Joseph e Ben Albahari (O’Reilly), “um dos melhores livros de programação que já li”. Para a edição de 2026, as fontes principais são:
- a documentação oficial da Microsoft: https://learn.microsoft.com/en-us/dotnet/ (guia da linguagem C#, referência das APIs do .NET, ASP.NET Core, Entity Framework Core);
- a página de novidades de cada versão do C#: https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/;
- as sucessivas edições de “C# in a Nutshell” de Joseph Albahari (O’Reilly), que continuam sendo uma excelente referência.