Iron Suite for .NET
10 bibliotecas .NET. Um conjunto completo de documentos.
Migrando para o .NET 11? Verifique estas mudanças importantes primeiro
.NET 11 está próximo, e a lista de alterações significativas já está disponível. Nós a analisamos linha por linha para que você possa iniciar a atualização sabendo o que procurar.
Isso é uma boa notícia, mas também torna os testes de migração mais importantes.
Muitas aplicações ainda compilarão sem problemas após redirecionar para .NET 11. O maior risco é a mudança de comportamento: código que compila com sucesso, mas lança uma nova exceção, manipula dados de forma diferente ou produz resultados ligeiramente diferentes em tempo de execução.
Em vez de percorrer cada item de compatibilidade um por um, este guia foca nas mudanças mais prováveis de afetar aplicações reais e no que você deve testar antes de mover para produção.
Tudo em uma tabela
| Mudança | O que acontece |
|---|---|
| Leitura de ZIP valida CRC32 | Lança InvalidDataException em entradas corrompidas |
DateOnly/TimeOnly TryParse | Lança em formato ou estilo inválido |
Falha BackgroundService | Host lança na inicialização/desligamento |
| Correção de Math.Round | Retorna resultados corretamente arredondados |
| Extensões no framework compartilhado | Resolução de versão de assembly pode mudar |
| Ferramentas de build e teste | Mudanças em VSTest, NuGet, template-engine |
A que verificaríamos primeiro: leitura de ZIP agora lança
Esta é a mudança mais provável de surpreender uma base de código rica em documentos, porque é silenciosa até que não seja. A partir do .NET 11, System.IO.Compression valida o checksum CRC32 quando você lê uma entrada ZIP e lança InvalidDataException se o checksum armazenado não corresponder aos dados. Anteriormente, uma entrada corrompida ou adulterada era lida sem reclamações.
Essa é uma mudança genuinamente boa, você quer saber quando um arquivo está ruim, mas se seu aplicativo ingere arquivos ZIP de usuários, parceiros ou de um antigo bucket de armazenamento, código que "funcionou" por anos pode começar a lançar exceções. A correção é pequena: envolva sua leitura em um try-catch para InvalidDataException e decida como deseja lidar com um arquivo corrompido. Melhor capturá-lo de propósito do que descobri-lo em produção.
A sorrateira: TryParse agora pode lançar
Todo desenvolvedor .NET internalizou que TryParse nunca lança exceções, ele retorna um bool. No .NET 11, DateOnly.TryParse, TimeOnly.TryParse, e seus TryParseExact irmãos quebram esse hábito ligeiramente: passe um valor DateTimeStyles inválido ou um especificador de formato ruim e eles agora lançam ArgumentException em vez de retornar false silenciosamente. Se suas strings de formato e estilos são codificados e válidos, nada muda. Se eles são calculados em tempo de execução ou vêm de entrada do usuário, esse é um novo caminho de exceção a cobrir.
Verifique apenas se for o seu caso
O restante é mais restrito e agrupado por onde eles vivem:
- ASP.NET Core. APIs antigas do Blazor marcadas como obsoletas há anos não compilam mais. Kestrel é mais rigoroso sobre cabeçalhos HTTP malformados. E se sua string de conexão SQL usa autenticação Entra ID (
Active Directory), agora você precisa do pacoteMicrosoft.Data.SqlClient.Extensions.Azure, isso também afeta usuários do EF Core SQL Server. - Extensões e hospedagem. Serviços de trabalho falham mais alto: se um
BackgroundServicelançar, o host também lança, então teste seu caminho de inicialização. - Bibliotecas principais.
Math.Rounde números complexos ficaram mais corretos em termos de padrões, o que só importa se os testes esperam os valores antigos. - Build e ferramentas. VSTest remove Newtonsoft.Json, pacotes de template removem netstandard2.0. Isso aparece como erros de build, então eles se anunciam.
- Plataforma. Os requisitos mínimos de CPU aumentaram, .NET MAUI precisa do Android API 24, e a busca de certificados TLS no lado do servidor está desativada por padrão. Você saberá se isso se aplica a você.
Uma coisa com a qual você não precisará se preocupar
Enquanto você está auditando dependências para a prontidão do .NET 11, suas ferramentas de documentos não devem estar na lista. As bibliotecas Iron Suite são puramente gerenciadas em .NET e já funcionam em .NET 11 até o .NET Framework, então IronPDF, IronXL, e o restante da suíte se movem com seu aplicativo em vez de bloqueá-lo. Vale a pena notar, dado que a mudança de ZIP acima está bem ao lado do tipo de código de manipulação de arquivos que essas bibliotecas substituem, se você tem um sistema de documentos ou arquivos feito à mão, uma migração é um momento natural para passar essa parte para uma biblioteca que já acompanha cada lançamento do .NET.
Para a lista completa, incluindo as mudanças do ASP.NET Core que vivem em sua própria página, a referência de alterações significativas do Microsoft .NET 11 é a fonte para marcar. Atualizaremos este post à medida que essa lista crescer, já que ainda está se preenchendo.