Cambios importantes en .NET 10

Si va a migrar una aplicación a .NET 10, 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 Windows Forms.

En este artículo se clasifica cada cambio disruptivo como no compatible con el binario, no compatible con el origen o cambio de comportamiento:

  • Incompatibilidad binaria - cuando se ejecuta en el nuevo entorno de ejecución o componente, los archivos binarios existentes pueden experimentar un cambio importante en el comportamiento, como el error de carga o ejecución, y, si es así, requieren recompilación.

  • Incompatible a nivel de código fuente - cuando se vuelve a compilar mediante el nuevo SDK o componente o para tener como destino el nuevo entorno de ejecución, el código fuente existente puede requerir cambios en el código fuente para compilarse correctamente.

  • Cambio de comportamiento : el código y los archivos binarios existentes pueden comportarse de forma diferente en tiempo de ejecución. Si el nuevo comportamiento no es deseable, el código existente debe actualizarse y volver a compilarse.

Nota:

Este artículo sigue en desarrollo. No es una lista completa de los cambios importantes en .NET 10.

ASP.NET Core

Consulte Cambios importantes en ASP.NET Core 10.

Contenedores

Title Tipo de cambio
Las imágenes de .NET predeterminadas usan Ubuntu Cambio de comportamiento
dotnet test necesita un directorio base de artefactos vsTest grabable en contenedores Cambio de comportamiento

Bibliotecas de Core .NET

Title Tipo de cambio
Obsolescencia de la API Fuente incompatible
Cambio de comportamiento de ActivitySource.CreateActivity y ActivitySource.StartActivity Cambio de comportamiento
Las cargas sin fallo de SVE arm64 requieren máscara Binario/fuente incompatible
BufferedStream.WriteByte ya no realiza el vaciado implícito Cambio de comportamiento
Resolución de sobrecarga de C# 14 con parámetros span Cambio de comportamiento
Comportamiento coherente de Shift en matemáticas genéricas Cambio de comportamiento
Propagador de contexto de seguimiento predeterminado actualizado al estándar W3C Cambio de comportamiento
DriveInfo.DriveFormat devuelve tipos de sistema de archivos de Linux Cambio de comportamiento
Se quitó la anotación DynamicallyAccessedMembers del constructor de DefaultValueAttribute Binario/fuente incompatible
Tamaño de estructura explícito no permitido con InlineArray Incompatibilidad binaria
FilePatternMatch.Stem pasó a ser no anulable Origen incompatible/cambio de comportamiento
GnuTarEntry y PaxTarEntry ya no incluyen atime y ctime de forma predeterminada Cambio de comportamiento
El análisis de LDAP DirectoryControl ahora es más estricto Cambio de comportamiento
Normalización de la versión de MacCatalyst Cambio de comportamiento
Los mutex con nombre usan de forma predeterminada el ámbito de usuario en Unix Cambio de comportamiento
.NET tiempo de ejecución ya no proporciona controladores de señal de terminación predeterminados Cambio de comportamiento
System.Linq.AsyncEnumerable incluido en las bibliotecas principales Fuente incompatible
Validación de argumentos de Type.MakeGenericSignatureType Cambio de comportamiento

Criptografía

Title Tipo de cambio
CompositeMLDsa actualizado a draft-08 Cambio de comportamiento
CoseSigner.Key puede ser null Cambio de comportamiento/Incompatible con origen
Los miembros "SecretKey" de MLDsa y SlhDsa se han renombrado. Fuente incompatible
No se admiten los primitivos criptográficos de OpenSSL en macOS Cambio de comportamiento
Se requiere OpenSSL 1.1.1 o posterior en Unix Cambio de comportamiento
La validación de X500DistinguishedName es más estricta Cambio de comportamiento
Los parámetros de clave PublicKey y X509Certificate pueden ser NULL Cambio de comportamiento/Incompatible con origen
Se ha cambiado el nombre de la variable de entorno a DOTNET_OPENSSL_VERSION_OVERRIDE Cambio de comportamiento

Entity Framework Core (Marco de trabajo de entidades núcleo)

Consulte Cambios importantes en EF Core 10.

Extensiones

Title Tipo de cambio
BackgroundService ejecuta todo ExecuteAsync como una tarea Cambio de comportamiento
Corrección de problemas en GetKeyedService() y GetKeyedServices() con AnyKey Cambio de comportamiento
Valores NULL conservados en la configuración Cambio de comportamiento
El mensaje ya no está duplicado en la salida del registro de consola Cambio de comportamiento
ProviderAliasAttribute se movió al ensamblado Microsoft.Extensions.Logging.Abstractions Fuente incompatible
Se quitó la anotación DynamicallyAccessedMembers del código de Microsoft.Extensions.Configuration no seguro para trim Incompatibilidad binaria

Globalización

Title Tipo de cambio
Se ha cambiado el nombre de la variable de entorno a DOTNET_ICU_VERSION_OVERRIDE Cambio de comportamiento

Herramienta de instalación

Title Tipo de cambio
dotnet.acquire API para VS Code ya no siempre descarga la versión más reciente. Cambio de comportamiento

Interop

Title Tipo de cambio
La conversión del objeto COM IDispatchEx a IReflect falla Cambio de comportamiento
Las aplicaciones de un solo archivo ya no buscan bibliotecas nativas en el directorio del ejecutable Cambio de comportamiento
Especificar DllImportSearchPath.AssemblyDirectory solo busca en el directorio de ensamblados. Cambio de comportamiento

Networking

Title Tipo de cambio
Compatibilidad con HTTP/3 deshabilitada de forma predeterminada con PublishTrimmed Fuente incompatible
MailAddress valida los puntos consecutivos Cambio de comportamiento
Las respuestas HTTP en streaming están habilitadas de forma predeterminada en los clientes HTTP del explorador Cambio de comportamiento
Uri límites de longitud quitados Cambio de comportamiento

Reflexión

Title Tipo de cambio Versión introducida
Anotaciones más restringidas en InvokeMember/FindMembers/DeclaredMembers Comportamiento/origen incompatible
Validación del argumento Type.MakeGenericSignatureType Cambio de comportamiento

SDK y MSBuild

Title Tipo de cambio
.NET CLI --interactive usa true de forma predeterminada en escenarios de usuario Cambio de comportamiento
dotnet Los comandos de la CLI registran datos no relevantes para comandos en stderr Cambio de comportamiento
el empaquetado de herramientas de .NET crea paquetes de herramientas específicos de RuntimeIdentifier Cambio de comportamiento
Cambio de la configuración predeterminada del modo "manifiestos sueltos" al modo "conjuntos de cargas de trabajo" Cambio de comportamiento
DefineConstants para marcos de destino que no están disponibles en el momento de la evaluación Cambio de comportamiento
La cobertura de código EnableDynamicNativeInstrumentation tiene como valor predeterminado false Cambio de comportamiento
Los scripts dnx omiten la selección del SDK de global.json Cambio de comportamiento
El archivo dnx.ps1 ya no se incluye en .NET SDK Fuente incompatible
No se permiten comillas dobles en directivas de nivel de archivo Fuente incompatible
dotnet new sln el valor predeterminado es el formato de archivo SLNX. Cambio de comportamiento
dotnet package list realiza la restauración Cambio de comportamiento
dotnet restore audita paquetes transitivos Cambio de comportamiento
dotnet tool install --local crea el manifiesto de forma predeterminada Cambio de comportamiento
dotnet watch registra en stderr en lugar de stdout Cambio de comportamiento
project.json no se admite en dotnet restore Fuente incompatible
Compatibilidad con huella digital SHA-1 obsoleta en dotnet nuget sign Cambio de comportamiento
Se ha quitado la vía de escape MSBUILDCUSTOMBUILDEVENTWARNING Cambio de comportamiento
Gestión de recursos de configuración regional personalizada de MSBuild Cambio de comportamiento
Nu1510 se genera para las referencias directas que NuGet elimina. Fuente incompatible
Los paquetes NuGet sin recursos en tiempo de ejecución no se incluyen en deps.json Fuente incompatible
PackageReference sin una versión genera un error Cambio de comportamiento
PrunePackageReference privatiza las referencias directas que se pueden eliminar Cambio de comportamiento
Advertencias HTTP promocionadas a errores en dotnet package list y dotnet package search Cambio de comportamiento/Incompatible con origen
NUGET_ENABLE_ENHANCED_HTTP_RETRY variable de entorno eliminada Cambio de comportamiento
Los orígenes de auditoría de NuGet ya no permiten HTTP no seguro de forma predeterminada Cambio de comportamiento
NuGet registra un error para identificadores de paquete no válidos Cambio de comportamiento
ToolCommandName no establecido para paquetes que no son de herramientas Fuente incompatible
La instalación del paquete de plantilla comprueba las firmas de NuGet Cambio de comportamiento

Serialización

Title Tipo de cambio
System.Text.Json comprueba si hay conflictos de nombres de propiedad Cambio de comportamiento
XmlSerializer ya no omite las propiedades marcadas con ObsoleteAttribute Cambio de comportamiento

Windows Forms

Title Tipo de cambio
Obsolescencias de API Fuente incompatible
Las aplicaciones que hacen referencia tanto a WPF como a WinForms deben desambiguar los tipos MenuItem y ContextMenu Fuente incompatible
Se ha cambiado el nombre del parámetro en HtmlElement.InsertAdjacentElement Fuente incompatible
Truncamiento de la imagen de la casilla de TreeView Cambio de comportamiento
StatusStrip usa System RenderMode de forma predeterminada Cambio de comportamiento
System.Drawing OutOfMemoryException cambió a ExternalException Cambio de comportamiento

Windows Presentation Foundation (WPF)

Title Tipo de cambio
No se permiten ColumnDefinitions y RowDefinitions vacíos Fuente incompatible
El uso incorrecto de DynamicResource provoca el bloqueo de la aplicación Origen incompatible/cambio de comportamiento
  • Darrera actualització el