Alterações interruptivas no .NET 5

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

• Alterações interruptivas do compilador C# no C# 9/.NET 5
• Novidades do .NET 5