Cambios importantes en .NET 5

  • Artículo

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