Fale conosco
Desenvolvimento

C# 15 e .NET 11: union types, hierarquias closed e o aviso CS8509 que não quebra o build

32 min de leitura
C# 15 e .NET 11: union types, hierarquias closed e o aviso CS8509 que não quebra o build

C# 15 e .NET 11: union types, hierarquias closed e o aviso CS8509 que não quebra o build

O .NET 11 ficou disponível em 10 de novembro, durante a .NET Conf, junto com o C# 15 como versão padrão de linguagem para projetos que apontam para net11.0 . A manchete é a chegada de union types — o discriminated union que a comunidade C# pediu por mais de uma década — acompanhada de hierarquias fechadas com a palavra-chave closed . As duas features resolvem o mesmo problema estrutural: hoje, quando alguém adiciona um caso novo a um modelo de domínio, o compilador não tem como saber que o seu switch ficou incompleto.

Isso importa porque é exatamente o tipo de erro que passa em revisão de código, passa em teste e aparece em produção semanas depois, na forma de um _ => throw new UnreachableException() que finalmente é alcançado. A proposta do C# 15 é transformar esse silêncio em diagnóstico de compilação.

Há dois detalhes que a nota de release não destaca com o mesmo peso. O primeiro: a cobertura incompleta gera aviso (CS8509), não erro — ou seja, sem configuração de projeto o build continua verde. O segundo: na mesma data, o .NET 8 e o .NET 9 saíram de suporte. Quem está neles não tem mais patch de segurança, e migrar para a 11 não estende calendário nenhum.

Como o union muda o código de verdade

A sintaxe declara um tipo cujo valor é exatamente um de uma lista fechada de tipos de caso:

O compilador gera conversão implícita a partir de cada caso, então atribuir PaymentResult r = new Approved("tx_123"); funciona sem cerimônia. E o switch sobre esse valor é considerado exaustivo quando trata os três casos, sem precisar de braço _ :

Antes do C# 15, o caminho era uma classe base abstrata com subclasses seladas, uma interface marcadora ou uma biblioteca externa de Result<T> . Todas as três opções compartilham a mesma fraqueza: a hierarquia é aberta, ninguém garante que a lista de casos está completa, e o _ acaba virando o depósito de tudo o que se esqueceu.

A closed resolve o caso em que você já tem hierarquia e quer fechá-la:

O modificador diz ao compilador que só o próprio assembly pode derivar daquele tipo — um meio-termo entre abstract (qualquer um deriva) e sealed (ninguém deriva). A classe é implicitamente abstrata e, com a lista de subtipos diretos conhecida, o switch que cobre todos eles dispensa o braço descartável que hoje carrega um throw new UnreachableException() .

O que mais muda no runtime e nas bibliotecas

Runtime async : o runtime passa a executar async / await sem as máquinas de estado geradas pelo compilador, cortando alocações. As bibliotecas de base já usam o modelo internamente; a sua aplicação só adere com EnablePreviewFeatures ligado, o que significa não colocar isso em produção neste ciclo.

Compressão Zstandard em System.IO.Compression : deixa de ser dependência externa para cenários de payload grande em APIs e filas.

LINQ com FullJoin : o full outer join que sempre foi resolvido com duas consultas e concatenação.

CLI como app NativeAOT e servidor MSBuild persistente: ganho direto em pipeline, porque o primeiro build do agente esquenta menos.

ASP.NET Core 11 passa a emitir OpenAPI 3.2 por padrão e ganha tratamento de sessões inativas no Blazor Server; EF Core 11 acompanha o ciclo.

O relógio de suporte é a decisão mais urgente

O .NET 11 é uma versão STS: suporte até 14 de novembro de 2028. O problema é que o .NET 10 LTS termina praticamente na mesma data. Na prática, adotar a 11 não compra tempo de plataforma — compra linguagem e runtime. Quem precisa de janela longa continua planejando por versões LTS; quem quer as features precisa aceitar o ciclo de atualização anual.

E o .NET 8, que sustentou boa parte do parque corporativo brasileiro, parou de receber correções em 10 de novembro. Não é um alerta teórico: sem patch, qualquer falha nova na plataforma fica aberta até você migrar. Nos projetos que acompanhamos na Maquinaweb, com times em .NET, Python, Node.js e Angular, esse tipo de decisão aparece cedo no desenho da arquitetura: vale mais manter um plano de atualização contínuo do que congelar a stack e pagar a migração inteira de uma vez.

Riscos e armadilhas que passam batido

O aviso não quebra o build. Sem configuração explícita, um switch incompleto compila. Coloque o diagnóstico na lista de erros:

Braço descartável desliga o check. Se houver um _ => , o compilador não emite CS8509 — o caso novo cai ali sem aviso nenhum. Em código novo, trate _ sobre union ou closed como proibido em revisão.

default(Union) não tem caso. Union é struct : o valor padrão não é nenhum dos casos, e o campo interno vem nulo. Antes de fazer switch , valide a instância, ou você vai perseguir um NullReferenceException que o compilador não aponta.

Union é por tipo, não por tag. Dois casos com a mesma forma estrutural não são distinguidos por rótulo, diferente de F# ou Rust. Se o seu domínio precisa de dois casos idênticos com significados distintos, use records nomeados distintos.

Serialização é contrato. O shape gerado pelo System.Text.Json para um union não é o mesmo de uma hierarquia polimórfica. Antes de expor o tipo em uma API pública, gere o JSON e revise — mudar isso depois quebra cliente.

Novo caso em biblioteca é breaking change. Se a union ou a hierarquia closed está em um pacote consumido por outros times, adicionar caso altera o contrato. Versione como mudança de minor consciente, com nota de release.

Recomendação prática

Para código novo, comece pequeno: um resultado de operação ( Sucesso / Validacao / Conflito ) em um serviço que hoje devolve object ou lança exceção para fluxo esperado. Ligue CS8509 como erro no mesmo commit. Para código existente, não refatore hierarquias de domínio de uma vez — a closed é aditiva e pode ser aplicada por módulo, sem tocar em bibliotecas que precisam ser estendidas por outros assemblies.

O passo obrigatório, esse sim, é o inventário: liste quais aplicações ainda rodam em .NET 8 ou 9 e defina prazo. Isso não é opcional a partir de novembro de 2026.

Se o seu time está avaliando migrar de stack, fechar o desenho de um domínio com tipos mais expressivos ou tirar um projeto sob medida do papel, fale com o time de engenharia da Maquinaweb — é uma empresa de desenvolvimento de software de grande porte, com equipe multidisciplinar e atuação nacional, acostumada a discutir essas escolhas com dados na mesa.

Fontes

#C# #.NET 11 #C# 15 #union types #ASP.NET Core #EF Core #migração #backend #tipagem
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.