Alterações interruptivas no .NET 5

  • Artigo

Se você estiver migrando um aplicativo para o .NET 5, 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 criptografia.

Este artigo indica se cada alteração interruptiva é compatível com binários ou compatível com o código-fonte:

  • Compatível com binários – Os binários existentes serão carregados e executados com êxito sem recompilação e o comportamento em tempo de execução não será alterado.
  • Compatível com o código-fonte – O código-fonte será compilado com êxito sem alterações durante o redirecionamento ao novo runtime ou quando um novo SDK ou componente for usado.

ASP.NET Core

Título Compatível com binários Compatível com a origem
Os aplicativos ASP.NET Core desserializam números entre aspas ✔️ ❌
APIs do AzureAD.UI e do AzureADB2C.UI obsoletas ✔️ ❌
Os métodos de serialização BinaryFormatter estão obsoletos ✔️ ❌
O recurso no roteamento de ponto de extremidade é HttpContext ✔️ ❌
Pacotes de integração do Azure prefixados com Microsoft removidos ❌ ✔️
Blazor: Lógica de precedência de rota alterada em aplicativos Blazor ✔️ ❌
Blazor: suporte a navegadores atualizado ✔️ ✔️
Blazor: espaço em branco não significativo cortado pelo compilador ✔️ ❌
Blazor: os tipos JSObjectReference e JSInProcessObjectReference são internos ✔️ ❌
Blazor: estrutura de destino de pacotes NuGet alterada ❌ ✔️
Blazor: o recurso ProtectedBrowserStorage foi movido para a estrutura compartilhada ✔️ ❌
Blazor: os campos públicos somente leitura RenderTreeFrame agora são propriedades ❌ ✔️
Blazor: lógica de validação atualizada para ativos da Web estáticos ❌ ✔️
APIs de criptografia sem suporte no navegador ❌ ✔️
Extensões: alterações de referência de pacote ❌ ✔️
Os tipos Kestrel e IIS BadHttpRequestException estão obsoletos ✔️ ❌
Instâncias de HttpClient criadas por códigos de status de inteiro de log IHttpClientFactory ✔️ ❌
HttpSys: renegociação de certificado do cliente desabilitada por padrão ✔️ ❌
IIS: as cadeias de caracteres de consulta de middleware UrlRewrite são preservadas ✔️ ❌
Kestrel: alterações de configuração detectadas por padrão ✔️ ❌
Kestrel: versões do protocolo TLS com suporte padrão alteradas ✔️ ❌
Kestrel: HTTP/2 desabilitado via TLS em versões incompatíveis do Windows ✔️ ✔️
Kestrel: transporte do Libuv marcado como obsoleto ✔️ ❌
Propriedades obsoletas em ConsoleLoggerOptions ✔️ ❌
Classe ResourceManagerWithCultureStringLocalizer e membro de interface WithCulture removidos ✔️ ❌
APIs do Pubternal removidas ✔️ ❌
Construtor obsoleto removido no middleware de localização de solicitação ✔️ ❌
Middleware: página de erro do banco de dados marcada como obsoleta ✔️ ❌
O middleware do manipulador de exceção gera uma exceção original ✔️ ✔️
ObjectModelValidator chama uma nova sobrecarga de Validate ✔️ ❌
Codificação de nome de cookie removida ✔️ ❌
Versões de pacote NuGet IdentityModel atualizadas ❌ ✔️
SignalR: tipo de opções de protocolo do hub MessagePack alterado ✔️ ❌
SignalR: protocolo do hub MessagePack removido ✔️ ❌
Métodos UseSignalR e UseConnections removidos ✔️ ❌
Tipo de conteúdo CSV alterado para em conformidade com padrões ✔️ ❌

Análise de código

Title Compatível com binários Compatível com a origem
Aviso CA1416 ✔️ ❌
Aviso CA1417 ✔️ ❌
Aviso CA1831 ✔️ ❌
Aviso CA2013 ✔️ ❌
Aviso CA2014 ✔️ ❌
Aviso CA2015 ✔️ ❌
Aviso CA2200 ✔️ ❌
Aviso CA2247 ✔️ ❌

Bibliotecas principais do .NET

Título Compatível com binários Compatível com a origem
Alterações de APIs relacionadas a assembly para publicação de arquivo único ❌ ✔️
Os métodos de serialização BinaryFormatter estão obsoletos ✔️ ❌
As APIs de segurança de acesso do código estão obsoletas ✔️ ❌
CreateCounterSetInstance gera InvalidOperationException ✔️ ❌
O ActivityIdFormat padrão é W3C ❌ ✔️
Environment.OSVersion retorna a versão correta ❌ ✔️
O valor de FrameworkDescription é .NET, não .NET Core ✔️ ❌
As APIs do GAC estão obsoletas ✔️ ❌
Verificações de IsSupported de intrínsecos de hardware ❌ ✔️
IntPtr e UIntPtr implementam IFormattable ✔️ ❌
LastIndexOf lida com cadeias de caracteres de pesquisa vazias ❌ ✔️
Caminhos de URI com caracteres não ASCII no UNIX ❌ ✔️
Obsolescências de API com IDs de diagnóstico não padrão ✔️ ❌
Propriedades obsoletas em ConsoleLoggerOptions ✔️ ❌
Complexidade de OrderBy.First da LINQ ❌ ✔️
Atributos OSPlatform renomeados ou removidos ✔️ ❌
Pacote Microsoft.DotNet.PlatformAbstractions removido ❌ ✔️
PrincipalPermissionAttribute está obsoleto ✔️ ❌
Alterações de nome de parâmetro de versões prévias ✔️ ❌
Alterações de nome de parâmetro em assemblies de referência ✔️ ❌
As APIs de comunicação remota estão obsoletas ❌ ✔️
A ordem da lista de Activity.Tags está invertida ✔️ ❌
Os métodos de comparação SSE e SSE2 manipulam NaN ✔️ ❌
Thread.Abort está obsoleto ✔️ ❌
Reconhecimento de URI de caminhos UNC no UNIX ❌ ✔️
Os caminhos do código UTF-7 estão obsoletos ✔️ ❌
Alteração de comportamento para Vector2.Lerp e Vector4.Lerp ✔️ ❌
Vector<T> lança NotSupportedException ❌ ✔️

Criptografia

Título Compatível com binários Compatível com a origem
APIs de criptografia sem suporte no navegador ❌ ✔️
Cryptography.OID é somente inicialização ✔️ ❌
Conjuntos de criptografia TLS padrão no Linux ❌ ✔️
As sobrecargas Create() em abstrações criptográficas estão obsoletas ✔️ ❌
Valor de FeedbackSize padrão alterado ✔️ ❌

Entity Framework Core

Alterações interruptivas no EF Core 5.0

Globalização

Title Compatível com binários Compatível com a origem
Usar bibliotecas ICU no Windows ❌ ✔️
StringInfo e TextElementEnumerator são compatíveis com UAX29 ❌ ✔️
Categoria Unicode alterada para caracteres Latin-1 ✔️ ❌
Valores TextInfo.ListSeparator alterados ✔️ ❌

Interoperabilidade

Title Compatível com binários Compatível com a origem
O suporte para WinRT foi removido ❌ ✔️
A conversão de RCW em InterfaceIsIInspectable gera exceção ❌ ✔️
Nenhuma investigação de sufixo A/W em plataformas não Windows ❌ ✔️

Rede

Título Compatível com binários Compatível com a origem
A manipulação de caminho de cookie está em conformidade com a RFC 6265 ✔️ ❌
LocalEndPoint é atualizado após chamar SendToAsync ✔️ ❌
MulticastOption.Group não aceita nulo ✔️ ❌
Fluxos permitem operações Begin sucessivas ❌ ✔️
WinHttpHandler removido do runtime do .NET ❌ ✔️

.

Title Compatível com binários Compatível com a origem
Arquivos Directory.Packages.prop importados por padrão ❌ ✔️
Erro gerado quando o projeto executável referencia executável incompatível ✔️
FrameworkReference substituído pelo WindowsSdkPackageVersion para o SDK do Windows ✔️ ❌
Símbolo de pré-processador de NETCOREAPP3_1 não definido ✔️ ❌
OutputType definido como WinExe ❌ ✔️
Alteração de comportamento de PublishDepsFilePath ❌ ✔️
Alteração de TargetFramework de netcoreapp para net ❌ ✔️
Os aplicativos WinForms e WPF usam Microsoft.NET.Sdk ❌ ✔️

Segurança

Título Compatível com binários Compatível com a origem
As APIs de segurança de acesso do código estão obsoletas ✔️ ❌
PrincipalPermissionAttribute está obsoleto ✔️ ❌
Os caminhos do código UTF-7 estão obsoletos ✔️ ❌

Serialização

Título Compatível com binários Compatível com a origem
BinaryFormatter.Deserialize reencapsula exceções ✔️ ❌
JsonSerializer.Desserialize requer cadeia de caracteres de caractere único ✔️ ❌
Os aplicativos ASP.NET Core desserializam números entre aspas ✔️ ❌
JsonSerializer.Serialize gera ArgumentNullException ✔️ ❌
Construtores não públicos sem parâmetros não usados para desserialização ✔️ ❌
As opções são respeitadas ao serializar pares chave-valor ✔️ ❌

Windows Forms

Título Compatível com binários Compatível com a origem
O código nativo não pode acessar objetos Windows Forms ✔️ ❌
OutputType definido como WinExe ❌ ✔️
DataGridView não redefine fontes personalizadas ✔️ ❌
Os métodos geram ArgumentException ✔️ ❌
Os métodos geram ArgumentNullException ✔️ ❌
As propriedades geram ArgumentOutOfRangeException ✔️ ❌
TextFormatFlags.ModifyString está obsoleto ✔️ ❌
As APIs do DataGridView geram InvalidOperationException ✔️ ❌
Os aplicativos WinForms usam Microsoft.NET.Sdk ❌ ✔️
Controles de barra de status removidos ✔️ ❌

WPF

Title Compatível com binários Compatível com a origem
OutputType definido como WinExe ❌ ✔️
Aplicativos WPF usam Microsoft.NET.Sdk ❌ ✔️

Confira também