Cambios importantes en .NET 5

Si va a migrar una aplicación a .NET 5, es posible que le afecten los cambios importantes que se enumeran aquí. Los cambios se agrupan por área tecnológica, como ASP.NET Core o criptografía.

En este artículo se indica si cada cambio importante es compatible con binarios o compatible con el origen:

• Compatible con binarios: los archivos binarios existentes se cargarán y ejecutarán correctamente sin volver a compilarse y el comportamiento en tiempo de ejecución no cambiará.
• Compatible con el origen: el código fuente se compilará correctamente sin cambios al dirigirse al nuevo entorno de ejecución o mediante el SDK o componente nuevo.

ASP.NET Core

Título	Compatibles con elementos binarios	Compatibles con el origen
Las aplicaciones ASP.NET Core deserializan los números entrecomillados	✔️	❌
API de AzureAD.UI y AzureADB2C.UI obsoletas	✔️	❌
Los métodos de serialización BinaryFormatter obsoletos están obsoletos	✔️	❌
El recurso en el enrutamiento de punto de conexión es HttpContext	✔️	❌
los paquetes de integración de Azure con Microsoft como prefijo se han quitado	❌	✔️
Blazor: lógica de precedencia de ruta cambiada en aplicaciones Blazor	✔️	❌
Blazor: compatibilidad con exploradores actualizada	✔️	✔️
Blazor: espacio en blanco insignificante recortado por el compilador	✔️	❌
Blazor: los tipos JSObjectReference y JSInProcessObjectReference son internal	✔️	❌
Blazor: Plataforma de destino de paquetes NuGet cambiada	❌	✔️
Blazor: La característica ProtectedBrowserStorage se ha movido a una plataforma compartida	✔️	❌
Blazor: los campos públicos RenderTreeFrame de solo lectura ahora son propiedades	❌	✔️
Blazor: Lógica de validación actualizada para los recursos web estáticos	❌	✔️
Las API de criptografía no se admiten en el explorador	❌	✔️
Extensiones: cambios de referencia de paquete	❌	✔️
Los tipos BadHttpRequestException de Kestrel e IIS están obsoletos	✔️	❌
instancias de HttpClient creadas por códigos de estado enteros del registro de IHttpClientFactory	✔️	❌
HttpSys: Deshabilitación predeterminada de la renegociación del certificado de cliente	✔️	❌
IIS: Mantenimiento de las cadenas de consulta de middleware de UrlRewrite	✔️	❌
Kestrel: cambios de configuración detectados de forma predeterminada	✔️	❌
Kestrel: versiones del protocolo TLS admitidas de forma predeterminada cambiadas	✔️	❌
Kestrel: Deshabilitación de HTTP/2 sobre TLS en versiones de Windows incompatibles	✔️	✔️
Kestrel: transporte de libuv marcado como obsoleto	✔️	❌
Propiedades obsoletas en ConsoleLoggerOptions	✔️	❌
se han eliminado la clase ResourceManagerWithCultureStringLocalizer y el miembro de interfaz WithCulture	✔️	❌
API Pubternal quitadas	✔️	❌
Se ha quitado el constructor obsoleto en el middleware de localización de solicitudes	✔️	❌
Middleware: página de errores de la base de datos marcada como obsoleta	✔️	❌
El middleware del controlador de excepciones produce una excepción original	✔️	✔️
Llamada a una nueva sobrecarga de Validate por parte de ObjectModelValidator	✔️	❌
Se ha quitado la codificación de nombre de cookie	✔️	❌
Se han actualizado las versiones del paquete NuGet IdentityModel	❌	✔️
SignalR: se ha cambiado el tipo de opciones del protocolo de concentrador de MessagePack	✔️	❌
SignalR: se ha trasladado el protocolo de concentrador MessagePack	✔️	❌
los métodos UseSignalR y UseConnections se han quitado	✔️	❌
tipo de contenido CSV cambiado a compatible con los estándares	✔️	❌

Análisis de código

Título	Compatibles con elementos binarios	Compatibles con el origen
Advertencia CA1416	✔️	❌
Advertencia CA1417	✔️	❌
Advertencia CA1831	✔️	❌
Advertencia CA2013	✔️	❌
Advertencia CA2014	✔️	❌
Advertencia CA2015	✔️	❌
Advertencia CA2200	✔️	❌
Advertencia CA2247	✔️	❌

Bibliotecas de Core .NET

Título	Compatibles con elementos binarios	Compatibles con el origen
Cambios de API relacionados con ensamblados para la publicación de un solo archivo	❌	✔️
Los métodos de serialización BinaryFormatter obsoletos están obsoletos	✔️	❌
Las API de seguridad de acceso del código están obsoletas	✔️	❌
CreateCounterSetInstance throws InvalidOperationException	✔️	❌
El valor predeterminado de ActivityIdFormat es W3C	❌	✔️
Environment.OSVersion devuelve la versión correcta	❌	✔️
El valor de FrameworkDescription es .NET, no .NET Core	✔️	❌
Las API de GAC están obsoletas	✔️	❌
Comprobaciones IsSupported intrínsecas de hardware	❌	✔️
IntPtr y UIntPtr implementan IFormattable	✔️	❌
LastIndexOf controla cadenas de búsqueda vacías	❌	✔️
Rutas de acceso de URI con caracteres que no son ASCII en UNIX	❌	✔️
Obsolescencias de API con identificadores de diagnóstico no predeterminados	✔️	❌
Propiedades obsoletas en ConsoleLoggerOptions	✔️	❌
Complejidad de LINQ OrderBy.First	❌	✔️
Atributos de OSPlatform que se han cambiado de nombre o se han quitado	✔️	❌
Retirada del paquete Microsoft.DotNet.PlatformAbstractions	❌	✔️
PrincipalPermissionAttribute está obsoleto	✔️	❌
Cambios de nombre de parámetro respecto a las versiones preliminares	✔️	❌
Cambios de nombre de parámetro en ensamblados de referencia	✔️	❌
Las API de comunicación remota están obsoletas	❌	✔️
Se ha invertido el orden de la lista de Activity.Tags	✔️	❌
Los métodos de comparación SSE y SSE2 controlan NaN	✔️	❌
Thread.Abort obsoleto	✔️	❌
Reconocimiento de URI de rutas UNC en UNIX	❌	✔️
Las rutas de acceso al código UTF-7 están obsoletas	✔️	❌
Cambio de comportamiento de Vector2.Lerp y Vector4.Lerp	✔️	❌
Vector<T> inicia la excepción NotSupportedException	❌	✔️

Criptografía

Título	Compatibles con elementos binarios	Compatibles con el origen
Las API de criptografía no se admiten en el explorador	❌	✔️
Cryptography.Oid es de solo inicialización	✔️	❌
Conjuntos de cifrado TLS predeterminados en Linux	❌	✔️
Las sobrecargas de Create() en abstracciones criptográficas están obsoletas	✔️	❌
Valor FeedbackSize predeterminado cambiado	✔️	❌

Entity Framework Core

Cambios importantes en EF Core 5.0

Globalización

Título	Compatibles con elementos binarios	Compatibles con el origen
Uso de bibliotecas de ICU en Windows	❌	✔️
StringInfo y TextElementEnumerator son compatibles con UAX29	❌	✔️
Categoría Unicode modificada para caracteres del alfabeto latino 1	✔️	❌
Cambio de los valores de TextInfo.ListSeparator	✔️	❌

Interop

Título	Compatibles con elementos binarios	Compatibles con el origen
Se elimina la compatibilidad con WinRT	❌	✔️
Excepción al convertir un contenedor RCW en InterfaceIsIInspectable	❌	✔️
Exclusión del sondeo del sufijo A/W en plataformas que no son de Windows	❌	✔️

Funciones de red

Título	Compatibles con elementos binarios	Compatibles con el origen
La administración de rutas de acceso de cookies se ajusta a RFC 6265	✔️	❌
LocalEndPoint se actualiza después de llamar a SendToAsync	✔️	❌
MulticastOption.Group no acepta NULL	✔️	❌
Las secuencias permiten operaciones Begin sucesivas	❌	✔️
WinHttpHandler quitado del entorno de ejecución de .NET	❌	✔️

SDK

Título	Compatibles con elementos binarios	Compatibles con el origen
Archivos Directory.Packages.props importados de forma predeterminada	❌	✔️
Error generado cuando el proyecto ejecutable hace referencia a un ejecutable no coincidente		✔️
WindowsSdkPackageVersion reemplaza a FrameworkReference para Windows SDK	✔️	❌
Símbolo de preprocesador de NETCOREAPP3_1 no definido	✔️	❌
OutputType se establece en WinExe	❌	✔️
Cambio de comportamiento de PublishDepsFilePath	❌	✔️
Cambio de TargetFramework de netcoreapp a net	❌	✔️
Uso de Microsoft.NET.Sdk por parte de las aplicaciones de WinForms y WPF	❌	✔️

Seguridad

Título	Compatibles con elementos binarios	Compatibles con el origen
Las API de seguridad de acceso del código están obsoletas	✔️	❌
PrincipalPermissionAttribute está obsoleto	✔️	❌
Las rutas de acceso al código UTF-7 están obsoletas	✔️	❌

Serialización

Título	Compatibles con elementos binarios	Compatibles con el origen
BinaryFormatter.Deserialize vuelve a encapsular excepciones	✔️	❌
JsonSerializer.Deserialize requiere una cadena de un solo carácter	✔️	❌
Las aplicaciones ASP.NET Core deserializan los números entrecomillados	✔️	❌
JsonSerializer.Serialize inicia la excepción ArgumentNullException	✔️	❌
Constructores no públicos sin parámetros que no se usan para la deserialización	✔️	❌
Se respetan las opciones al serializar pares clave-valor	✔️	❌

Windows Forms

Título	Compatibles con elementos binarios	Compatibles con el origen
El código nativo no puede acceder a objetos Windows Forms.	✔️	❌
OutputType se establece en WinExe	❌	✔️
DataGridView no restablece las fuentes personalizadas	✔️	❌
Los métodos inician la excepción ArgumentException	✔️	❌
Los métodos inician la excepción ArgumentNullException	✔️	❌
Las propiedades inician la excepción ArgumentOutOfRangeException	✔️	❌
TextFormatFlags.ModifyString está obsoleto	✔️	❌
Excepción InvalidOperationException por parte de las API de DataGridView	✔️	❌
Uso de Microsoft.NET.Sdk por parte de las aplicaciones de WinForms	❌	✔️
Controles de la barra de estado quitados	✔️	❌

WPF

Título	Compatibles con elementos binarios	Compatibles con el origen
OutputType se establece en WinExe	❌	✔️
Uso de Microsoft.NET.Sdk por parte de las aplicaciones de WPF	❌	✔️

Consulte también

• cambios importantes del compilador de C# en C# 9/ .NET 5
• Novedades de .NET 5