Cambios importantes en .NET 11

Si va a migrar una aplicación a .NET 11, los cambios importantes que se enumeran aquí pueden afectarle. 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:

• Binario incompatible - Cuando se ejecuta en el nuevo entorno de ejecución o componente, los binarios existentes podrían experimentar un cambio significativo en el comportamiento, como fallos al cargar o ejecutar, y, si es así, requieren recompilación.

• Origen incompatible : cuando se vuelve a compilar con el nuevo SDK o componente o para tener como destino el nuevo entorno de ejecución, el código fuente existente puede requerir cambios de origen 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 cambios importantes en .NET 11.

ASP.NET Core

Consulte cambios importantes en ASP.NET Core 11.

Bibliotecas principales de .NET

Title	Tipo de cambio
El comportamiento de Assembly.GetCallingAssembly cambia cuando el soporte para el seguimiento de la pila está deshabilitado	Cambio de comportamiento
CborReader y CborWriter aplican una profundidad de anidamiento máxima predeterminada	Cambio de comportamiento
Los resultados complejos de valor especial siguen ahora el Anexo G C23	Cambio de comportamiento
Validación CRC32 agregada al leer entradas de archivo ZIP	Cambio de comportamiento
Los métodos DateOnly y TimeOnly TryParse arrojan con entrada no válida	Cambio de comportamiento
Las conversiones a coma flotante de Decimal y BigInteger están correctamente redondeadas	Cambio de comportamiento
DeflateStream y GZipStream escriben encabezados y pies de página para cargas vacías	Cambio de comportamiento
Environment.GetCommandLineArgs()[0] conserva el nombre de invocación de apphost.	Cambio de comportamiento
Environment.TickCount se ha alineado con el comportamiento del tiempo de espera de Windows	Cambio de comportamiento
Los envoltorios de recopilación y enumerador de WMI generados implementan IDisposable	Cambio de origen/comportamiento
Math.Round y MathF.Round devuelven resultados redondeados correctamente	Cambio de comportamiento
Mutex con nombre usan el ámbito de usuario de forma predeterminada en Unix	Cambio de comportamiento
NamedPipeServerStream con PipeOptions.CurrentUserOnly endurece los permisos de archivo de socket Unix.	Cambio de comportamiento
Nullable.GetUnderlyingType lanza una excepción para las subclases de Type personalizadas	Cambio de comportamiento
PackagePart.GetStream() devuelve una secuencia no buscable para partes comprimidas en paquetes ReadWrite	Cambio de comportamiento
Obsolescencias de API con ID de diagnóstico no predeterminados (.NET 11)	Fuente incompatible
SafeFileHandle.IsAsync y FileStream.IsAsync reflejan con precisión el estado de no bloqueo en Unix	Cambio de comportamiento
Las API de lectura de TAR verifican las sumas de comprobación de encabezado en las operaciones de lectura	Cambio de comportamiento
TarWriter usa entradas de HardLink para archivos vinculados de forma permanente	Cambio de comportamiento
Las operaciones de Tensor alinean formas equivalentes y tensores vacíos	Cambio de comportamiento
Las operaciones de tensor rechazan las disposiciones de almacenamiento no admitidas	Cambio de comportamiento
ZipArchive.CreateAsync carga diligentemente entradas de archivo ZIP	Cambio de comportamiento

Criptografía

Title	Tipo de cambio
Obsolescencias de API	Fuente incompatible
La ML-DSA compuesta en Windows usa la implementación nativa	Cambio de comportamiento
DSA quitado de macOS	Cambio de comportamiento
HKDF en Windows usa la implementación de CNG	Cambio de comportamiento
La obtención de certificados AIA en Linux se limita a dos recuperaciones por compilación de cadena	Cambio de comportamiento

Deployment

Title	Tipo de cambio
Las configProperties de .runtimeconfig.dev.json anulan las de .runtimeconfig.json	Cambio de comportamiento

Extensiones

Title	Tipo de cambio
Las sobrecargas asíncronas de ChangeToken.OnChange vuelven a vincular las llamadas de retorno existentes que devuelven tareas	Cambio de comportamiento
La eliminación del ámbito de la inyección de dependencias agrega excepciones	Cambio de comportamiento
Las cadenas vacías en una configuración encadenada anulan a los proveedores anteriores	Cambio de comportamiento
FileConfigurationProvider no genera el token de recarga después de un error de carga omitido	Cambio de comportamiento
La callback FileConfigurationSource.OnLoadException se invoca en caso de errores de E/S.	Cambio de comportamiento
IHost.RunAsync e IHost.StopAsync se activan cuando se produce un error en BackgroundService	Cambio de comportamiento
El generador de validación de opciones informa de SYSLIB1205 para implementaciones explícitas de Validate	Fuente incompatible
PhysicalFilesWatcher valida las rutas raíz y FileSystemWatcher	Cambio de comportamiento
Algunos paquetes de Microsoft.Extensions incluidos en el entorno compartido	Cambio de comportamiento
El acceso sincrónico a opciones validadas de forma asíncrona lanza una excepción	Comportamiento/origen incompatible

Globalización

Title	Tipo de cambio
Fecha mínima admitida del calendario japonés corregida	Cambio de comportamiento

Interop

Title	Tipo de cambio
AOT nativo rechaza firmas no blittables UnmanagedCallersOnly	Cambio de comportamiento
NativeAOT usa el prefijo lib para las salidas de biblioteca nativa en Unix	Cambio de comportamiento

Compilador JIT

Title	Tipo de cambio
Las conversiones de punto flotante a tipos enteros pequeños son saturadas	Cambio de comportamiento
Requisitos mínimos de hardware actualizados	Cambio de comportamiento

Creación de redes

Title	Tipo de cambio
Las métricas de alta cardinalidad de HttpClient usan contadores observables	Cambio de comportamiento
Las descargas de certificados AIA del servidor SslStream están deshabilitadas por defecto	Cambio de comportamiento

.NET MAUI

Title	Tipo de cambio
Android x86 no se admite	Cambio de comportamiento o incompatible binario
La generación de código en dispositivos móviles cambia de Mono a CoreCLR	Origen incompatible/cambio de comportamiento
CoreCLR reemplaza el tiempo de ejecución de Mono para .NET aplicaciones móviles	Incompatibilidad binaria/de código fuente/cambio de comportamiento
Los eventos de seguimiento de CoreCLR reemplazan los eventos de seguimiento de Mono	Incompatibilidad binaria/de código fuente/cambio de comportamiento
Cambios de comportamiento de informes de fallos en plataformas móviles	Cambio de comportamiento
Las interfaces de depuración en plataformas móviles cambian a ICorDebug	Incompatibilidad binaria/de código fuente/cambio de comportamiento
Nivel mínimo de API de Android elevado a 24	Cambio de comportamiento
Las API de incrustación mono ya no se admiten en plataformas móviles	Incompatibilidad binaria/de código fuente/cambio de comportamiento
Las propiedades de proyecto Mono ya no configuran aplicaciones móviles	Origen incompatible/cambio de comportamiento
La configuración del tiempo de ejecución de Mono ya no configura las aplicaciones móviles	Comportamiento/origen incompatible
UnwindNativeCode no se admite en destinos de Apple	Origen incompatible/cambio de comportamiento

SDK y MSBuild

Title	Tipo de cambio
Los scripts dnx omiten la selección del SDK de global.json	Cambio de comportamiento
Compilación completa omitida para la publicación de Native AOT	Cambio de comportamiento
El destino de ejecución de Mono no se ha definido para aplicaciones .NET Framework	Cambio de comportamiento
Control de comandos de la CLI de NativeAOT habilitado de forma predeterminada	Cambio de comportamiento
NU1703 advierte sobre los paquetes que usan recursos del framework MonoAndroid en desuso	Fuente incompatible
El paquete NuGet advierte de los identificadores de paquete con caracteres restringidos	Cambio de comportamiento
La operación de restauración no busca una versión superior en la carpeta de paquetes globales	Fuente incompatible
La selección del entorno de ejecución del contenedor local del SDK prefiere herramientas nativas de la plataforma	Cambio de comportamiento
Los paquetes de motor de plantilla ya no admiten netstandard2.0	Binario/fuente incompatible
VSTest quita la dependencia de Newtonsoft.Json	Binario/fuente incompatible