C# Versões do C# e do .NET

Todo ano, em novembro, sai uma versão nova do .NET e, junto com ela, uma versão nova do C#. Por isso você vai ver tutoriais de ".NET 6", "C# 10", ".NET 8"… Nesta aula você aprende a diferença entre a versão da linguagem e a da plataforma, o que quer dizer LTS e STS, o que cada versão trouxe e o que acontece quando você usa um recurso novo numa versão antiga.

As datas desta aula foram conferidas em outubro de 2026 nas páginas oficiais da Microsoft (o histórico de versões do C# e a política de suporte do .NET). As saídas de terminal são da máquina da Ana, com o SDK 10.0.112.

A ideia: a língua e o dicionário

Pense no português. Existem as regras da língua (a gramática, o acordo ortográfico) e existe o dicionário que você tem na estante, com as palavras e os exemplos. Quando a regra muda, os dicionários novos já vêm com ela; um dicionário de 1990 não sabe nada do acordo ortográfico de 2009.

As duas andam juntas: cada .NET traz o compilador com a versão do C# do mesmo ano, e um projeto usa, por padrão, a versão do C# que combina com o .NET dele. O .NET 10 usa o C# 14; o .NET 8 usava o C# 12. Por isso tanta gente fala "o C# do .NET 8" em vez de "C# 12".

LTS e STS: quanto tempo cada versão é cuidada

Depois que uma versão sai, a Microsoft continua mandando correções: consertos de falhas de segurança e de erros, uma vez por mês (na segunda terça-feira, o Patch Tuesday). Mas não para sempre. Cada versão tem uma data de fim de suporte, e depois dela não recebe mais nada. Há dois tipos:

As duas são igualmente estáveis e testadas; só o tempo de cuidado muda. Empresas costumam ficar nas LTS, para não precisar atualizar todo ano. Quem gosta de usar as novidades primeiro vai de STS. Este guia usa o .NET 10, que é LTS.

A tabela do .NET

Três coisas para reparar:

• O .NET 8 (LTS de 3 anos) e o .NET 9 (STS de 2 anos) terminam no mesmo dia, 10 de novembro de 2026: daqui a menos de um mês, no momento em que esta aula foi escrita. Quem ainda usa um deles precisa passar para o .NET 10.
• O .NET 11 ainda não saiu: em outubro de 2026 ele está na versão de testes 11.0.0-rc.2 (release candidate, "candidata a lançamento"). Quando sair, o .NET 10 continua sendo a LTS mais nova, com suporte por mais tempo que o 11.
• Todas as versões até o .NET 7 já estão fora de suporte: elas funcionam, mas não recebem mais correções de segurança. Um tutorial com .NET Core 3.1 ou .NET 6 ainda ensina muita coisa certa, mas não use essas versões em programas novos.

O que cada versão do C# trouxe

O C# começou pequeno e ganhou recursos a cada versão. Você não precisa decorar esta tabela: ela serve para você saber, ao ver um código antigo, por que ele está escrito daquele jeito. Os links levam às aulas de cada recurso.

Repare na linha do C# 9: foi ele que permitiu o programa de uma linha só, Console.WriteLine("Olá, mundo!");. Antes dele, todo programa precisava de class Program e static void Main, e por isso os tutoriais antigos começam assim. A aula Program.cs e o Main mostra as duas formas lado a lado.

Um recurso novo na prática: as expressões de coleção

Até o C# 11, para criar uma lista fixa de números (um array), escrevia-se o tipo duas vezes. O C# 12 trouxe uma forma mais curta, com colchetes:

int[] notas = new int[] { 8, 9, 10 };   // até o C# 11
int[] notas = [8, 9, 10];               // C# 12 em diante

As duas criam exatamente o mesmo array. É assim que o guia marca um recurso novo: com o selo C# 12, que quer dizer "funciona do C# 12 em diante". Se você estiver num projeto antigo (por exemplo, .NET 6 ou 8), olhe o selo antes de copiar o exemplo.

int[] notas = new int[] { 8, 9, 10 };
Console.WriteLine($"A Ana tem {notas.Length} notas");

int[] notas = [8, 9, 10, 7];
Console.WriteLine($"A Ana tem {notas.Length} notas");

$ dotnet run notas.cs                           « a forma antiga
A Ana tem 3 notas
$ dotnet run notas12.cs                         « a forma nova, com a nota 7
A Ana tem 4 notas

Qual versão do C# eu tenho?

O compilador tem uma pergunta escondida: a linha #error version. O #error manda o compilador parar com um erro (é usado para avisar "não compile isto assim"), e a palavra version faz ele contar, nesse erro, a versão dele e a da linguagem:

Console.WriteLine("Olá!");
#error version

$ dotnet run versao.cs
/home/ana/cs/versao.cs(2,8): error CS1029: #error: "version"
/home/ana/cs/versao.cs(2,8): error CS8304: Compiler version: '5.0.0-2.26422.108 (95017c71)'. Language version: 14.0.

Ocorreu uma falha no build. Corrija os erros de build e execute novamente.

CS1029

O erro que o próprio #error pediu, com o texto que veio depois dele ("version").

CS8304

A resposta, em inglês (esta mensagem não tem tradução): Compiler version é a versão do Roslyn, o compilador (5.0.0), e Language version: 14.0 é a versão do C# que ele está usando.

Como é um erro, o programa não roda (nem o Olá! aparece). Use o truque e depois apague a linha.

Console.WriteLine("Olá!");
#error version

A versão do SDK e a do .NET

Já o comando dotnet --version mostra a versão do SDK, que tem um número de três partes:

$ dotnet --version
10.0.112

O Runtime tem o número mais simples: 10.0.12 (a 12.ª correção do .NET 10). Para comparar: em outubro de 2026, o site da Microsoft oferecia o SDK 10.0.402 e o Runtime 10.0.13; o Ubuntu 26.04 tinha o SDK 10.0.112 e o Runtime 10.0.12. Os dois são o .NET 10 com o C# 14: o Ubuntu fica na faixa 1xx e recebe as correções um pouco depois.

Usando uma versão mais antiga do C#

Às vezes você precisa saber se um código funciona numa versão antiga (por exemplo, porque a empresa ainda usa o .NET 8). Num projeto, a versão do C# fica no arquivo .csproj, com a propriedade LangVersion (aula O Arquivo .csproj). Num arquivo solto do dotnet run, o .NET 10 aceita a mesma propriedade numa linha especial no topo, que começa com #: (aula Rodar com dotnet run):

#:property LangVersion=11
int[] notas = [8, 9, 10, 7];
Console.WriteLine($"A Ana tem {notas.Length} notas");

$ dotnet run notas11.cs
/home/ana/cs/notas11.cs(2,15): error CS9058: O recurso 'expressões de coleção' não está disponível no C# 11.0. Use a versão do idioma 12.0 ou superior.

Ocorreu uma falha no build. Corrija os erros de build e execute novamente.

O compilador é o mesmo, mas foi mandado "fingir" que é o C# 11, e o C# 11 não conhece os colchetes. A mensagem diz exatamente o que fazer: usar o C# 12 ou mais novo. É essa a mensagem que aparece quando alguém copia um exemplo moderno para um projeto antigo.

Qual versão usar?

Quando dá errado

#:property LangVersion=13
var p = new Produto { Nome = "  café " };
Console.WriteLine($"[{p.Nome}]");
class Produto
{
    public string Nome { get; set => field = value.Trim(); } = "";
}

$ dotnet run field.cs
/home/ana/cs/field.cs(6,19): error CS9260: O recurso "campo palavra-chave" não está disponível no C# 13.0. Use a versão da linguagem 14.0 ou superior.

Ocorreu uma falha no build. Corrija os erros de build e execute novamente.

$ dotnet new console -o Antigo -f net8.0
Erro: Opções inválidas:
-f net8.0
   'net8.0' não é um valor válido para '-f'. Os valores possíveis são:
      net10.0   - Net10.0 de destino

Para obter mais informações, execute:
   dotnet new console -h

Para obter detalhes sobre o código de saída, consulte https://aka.ms/templating-exit-codes#127
$ echo $?
127

Referência

Exercícios

Missão final: a linha do tempo das LTS

Console.WriteLine(".NET 6: LTS de 2021");
Console.WriteLine(".NET 7: LTS de 2022");

Console.WriteLine(".NET 6: LTS de 2021");
Console.WriteLine(".NET 8: LTS de 2023");
Console.WriteLine(".NET 10: LTS de 2025");

Resumo

• A versão do C# diz o que você pode escrever; a do .NET diz o que vem pronto. Cada .NET usa uma versão do C# por padrão: .NET 10 → C# 14, .NET 8 → C# 12.
• Sai um .NET por ano, em novembro. As LTS (números pares) têm 3 anos de suporte; as STS (números ímpares), 2 anos.
• O .NET 8 e o .NET 9 saem de suporte em 10/11/2026. O .NET 10, LTS de novembro de 2025, tem suporte até 14/11/2028.
• dotnet --version mostra o SDK (10.0.112: .NET 10, faixa 1xx, correção 12); #error version mostra o C# (Language version: 14.0).
• Recurso novo em versão velha dá erro com a frase "não está disponível no C# X" (CS9058, CS9260). O selo C# 12 do guia avisa a versão mínima.
• Próximo passo: instalar o .NET 10, em Instalar no Linux ou Instalar no Windows e macOS.