Alterações significativas no .NET 11

Se você estiver migrando um aplicativo para o .NET 11, as alterações interruptivas listadas aqui poderão afetar você. As alterações são agrupadas por área de tecnologia, como ASP.NET Core ou Windows Forms.

Este artigo categoriza cada alteração interruptiva como incompatível binário ou incompatível com a origem ou alteração comportamental:

  • incompatibilidade binária – Quando executados no novo runtime ou componente, os binários existentes podem enfrentar uma alteração impactante no comportamento, como falha ao carregar ou executar. Nesse caso, necessitam de recompilação.

  • Fonte incompatível - Quando recompilado usando o novo SDK ou componente ou para destinar ao novo tempo de execução, o código-fonte existente pode exigir alterações para ser compilado com êxito.

  • Alteração comportamental – o código e os binários existentes podem se comportar de forma diferente no runtime. Se o novo comportamento for indesejável, o código existente precisará ser atualizado e recompilado.

Observação

Este artigo é um trabalho em andamento. Não é uma lista completa de alterações significativas no .NET 11.

Bibliotecas de .NET principais

Title Tipo de alteração
Validação CRC32 adicionada ao ler as entradas de arquivo ZIP Alteração de comportamento
Os métodos TryParse de DateOnly e TimeOnly lançam exceções para entradas inválidas Alteração de comportamento
DeflateStream e GZipStream escrevem cabeçalhos e rodapés para carga útil vazia Alteração de comportamento
Environment.TickCount agora é consistente com o comportamento de tempo limite do Windows Alteração de comportamento
Capacidade máxima do MemoryStream atualizada e comportamento de exceção alterado Alteração de comportamento
Obsolescência de API com IDs de diagnóstico não padrão (.NET 11) Origem incompatível
As APIs de leitura de TAR verificam os checksums do cabeçalho durante a leitura Alteração de comportamento
ZipArchive.CreateAsync carrega ansiosamente entradas de arquivo ZIP Alteração de comportamento

Criptografia

Title Tipo de alteração
DSA removido do macOS Alteração de comportamento

Extensões

Title Tipo de alteração
IHost.RunAsync e IHost.StopAsync são lançados quando um BackgroundService falha Alteração de comportamento

Globalization

Title Tipo de alteração
Data mínima com suporte do Calendário Japonês corrigida Alteração de comportamento

Interoperabilidade

Title Tipo de alteração
NativeAOT usa o prefixo lib para saídas de biblioteca nativa no Unix Alteração de comportamento

compilador JIT

Title Tipo de alteração
Requisitos mínimos de hardware atualizados Alteração de comportamento

SDK e MSBuild

Title Tipo de alteração
alvo de inicialização do mono não definido para aplicativos .NET Framework Alteração de comportamento