Fale conosco
Desenvolvimento

C# 15 traz union types ao .NET 11: switch exaustivo, JSON em Minimal APIs e o preço da migração

33 min de leitura
C# 15 traz union types ao .NET 11: switch exaustivo, JSON em Minimal APIs e o preço da migração

C# 15 traz union types ao .NET 11: switch exaustivo, JSON em Minimal APIs e o preço da migração

O .NET 11 foi liberado em 10 de novembro, primeiro dia do .NET Conf 2026, e chegou junto com C# 15, F# 11, ASP.NET Core 11 e EF Core 11. É uma versão STS (Standard Term Support), com dois anos de suporte — e não a LTS. Essa distinção importa mais do que a lista de features, porque o mesmo dia marcou o fim de suporte do .NET 8 e do .NET 9.

A novidade que realmente muda a forma de modelar domínio é o union type . É a maior alteração no sistema de tipos do C# desde os records da versão 9, seis anos atrás, e resolve um problema que todo time de médio porte já contornou com gambiarra: representar "isto é exatamente uma destas coisas" sem herança artificial, sem hierarquia aberta e sem enum que carrega dado solto ao lado.

Neste texto: como a sintaxe funciona, o que muda no JSON e no OpenAPI, onde o recurso não ajuda e o que costuma quebrar na atualização de versão.

A sintaxe e o switch que o compilador agora consegue checar

A declaração é uma linha. Você nomeia a união e lista os tipos que ela aceita:

A partir daí, o compilador faz três coisas: gera conversão implícita de cada tipo de caso para Pet , conhece a lista fechada e usa essa lista para validar o switch . O resultado é um switch exaustivo sem _ :

Adicionar Fish à lista de Pet transforma esse método em alvo de aviso do compilador imediatamente. Esse é o ganho real: o custo de esquecer um caso sobe do runtime para o build . Sem o _ , um caso novo não passa silenciosamente.

Detalhe de prática: por padrão o caso faltante é warning , não erro. Se o projeto usa TreatWarningsAsErrors — e em biblioteca compartilhada deveria —, vira build quebrado na hora. Vale saber qual dos dois você tem antes de fazer a atualização, porque a experiência de migração muda bastante.

closed : a alternativa para hierarquia que você já tem

Nem todo código cabe em união. Se o modelo é uma hierarquia de classes com comportamento compartilhado, o C# 15 oferece o modificador closed , que trava os subtipos diretos na mesma assembly:

Com isso, o compilador também consegue apontar o caso que falta no switch , sem que você precise trocar a modelagem. Na prática, é o caminho menos invasivo para um codebase que já usa polimorfismo e quer exaustividade sem refatorar tudo.

O impacto em ASP.NET Core 11 e Minimal APIs

O ASP.NET Core 11 passa a aceitar union types como tipo de corpo JSON em Minimal APIs, tanto na entrada quanto na saída, e o OpenAPI passa a ser 3.2 por padrão. Um endpoint de busca sai assim:

O schema gerado reflete a lista de casos, o que já ajuda o cliente a entender que a resposta é uma coisa ou outra. Duas recomendações que valem como avaliação de projeto, não como regra da linguagem: mantenha as listas planas em vez de aninhar uniões (a serialização e o schema ficam mais previsíveis) e revise os contratos publicados antes de trocar o formato de resposta que o front já consome — mudar de um object genérico para uma união nomeada altera o schema, mesmo quando o payload final é idêntico.

É exatamente esse tipo de decisão que aparece na mesa quando um time multidisciplinar, como o da Maquinaweb, precisa equilibrar stack moderna em .NET e C# com contratos de API já em produção em Angular e TypeScript — a feature nova só entra onde reduz risco, não onde aumenta.

Riscos e armadilhas da migração

O bolo de areia do .NET 11 não está nos unions, está na infraestrutura:

Baseline de CPU subiu para x86-64-v2. O runtime não sobe em hardware anterior a isso, e em Arm64 no Windows passa a exigir LSE. Build servers antigos, VMs legadas e alguns hosts de cliente ficam de fora. Teste o parque antes, não depois.

.NET 8 e .NET 9 saíram de suporte no mesmo dia. Quem ainda está na 8 precisa escolher entre migrar para .NET 10 (LTS) ou para .NET 11 (STS, dois anos). Para sistema de faturamento ou integração fiscal, LTS costuma ser a resposta; para serviço interno com release quinzenal, STS é razoável.

C# 15 é o padrão em net11.0 . Analisadores, regras de estilo e regras do Sonar/EditorConfig podem começar a reclamar de código que estava limpo, especialmente em switch que nunca cobriu todos os casos porque ninguém obrigava.

Alocação em hot path. A união guarda o valor de caso de forma genérica; com struct como caso, espere boxing em determinados caminhos. Antes de colocar união em loop de processamento, meça com benchmark — a legibilidade ganha quase sempre, o throughput não necessariamente.

Tooling de build mudou de comportamento. O .NET 11 liga um host AOT nativo para a CLI e o MSBuild server aquecido por padrão. Build local fica mais rápido, mas em container efêmero de CI você pode pagar o custo de subir esse servidor a cada job — compare tempos de pipeline antes de comemorar.

Runtime Async V2 aparece como opção ( runtime-async=on ), trocando as state machines geradas pelo compilador por execução gerenciada pelo runtime. Stack trace mais limpa, mas ainda é território de avaliação: não é o item para ligar no mesmo sprint em que você trocou a versão do framework.

Recomendação prática

Ordem que costuma funcionar em time de médio porte:

Suba primeiro as bibliotecas internas e os testes para net11.0 , mantendo os serviços em .NET 10. Você descobre quebras de analisador sem risco de produção.

Introduza union types em um único bounded context onde hoje existe Result ou (bool ok, string? erro) feito à mão. É o lugar de maior retorno e menor exposição.

Só depois mexa em infraestrutura: imagens base, agents de CI e hosts com CPU antiga.

Deixe runtime-async e Native AOT fora do escopo da primeira onda.

Se o time está começando um projeto novo em .NET agora, o desenho é diferente: union types e closed valem entrar desde o começo, porque modelar domínio com hierarquia aberta e depois fechar é refactor caro.

Quer discutir se o seu sistema deve ir para .NET 10 LTS ou .NET 11, ou precisa de um time para tocar essa migração e um projeto sob medida em paralelo? Fale com a Maquinaweb: a empresa tem atuação nacional, stack que vai de C# e .NET a Python, Node.js, Angular e bancos relacionais, e ajuda a decidir com base no seu parque, não no release note.

Fontes

#.NET 11 #C# 15 #union types #ASP.NET Core #Minimal APIs #backend #migração #LTS
Contato

Bora conversar?

Três campos. A resposta vem no WhatsApp.

Ou escreva para contato@maquinaweb.com.br.

Você vai para o WhatsApp com a mensagem pronta. Sem spam, sem lista.

Seus dados seguem a nossa política de privacidade.