Iron Suite for .NET

10 bibliotecas .NET. Una suite completa de documentos.

NOTICIAS DEL SECTOR

¿Migrando a .NET 11? Primero revise estos cambios importantes

Curtis Chau
Curtis Chau
Actualizado: 31 de agosto de 2026

.NET 11 está cerca, y la lista de cambios importantes ya está disponible. La revisamos línea por línea para que puedas abordar la actualización sabiendo qué buscar.

Eso es una buena noticia, pero también hace que las pruebas de migración sean más importantes.

Muchas aplicaciones seguirán compilando sin problemas después de cambiar a .NET 11. El mayor riesgo es el cambio de comportamiento: código que se compila con éxito pero lanza una nueva excepción, maneja datos de manera diferente o produce resultados ligeramente diferentes en tiempo de ejecución.

En lugar de revisar cada elemento de compatibilidad uno por uno, esta guía se centra en los cambios que probablemente afecten a aplicaciones reales y lo que deberías probar antes de pasar a producción.

Todo en una tabla

CambioQué sucede
Lectura de ZIP valida CRC32Lanza InvalidDataException en entradas corruptas
DateOnly/TimeOnly TryParseLanza en formato o estilo inválido
BackgroundService fallaEl host lanza en inicio/apagado
Corrección de Math.RoundDevuelve resultados correctamente redondeados
Extensiones en marco compartidoLa resolución de versión de ensamblado puede cambiar
Herramientas de construcción y pruebaCambios en VSTest, NuGet, motor de plantillas

El que verificaríamos primero: la lectura de ZIP ahora lanza

Este es el cambio que probablemente sorprenda a una base de código con muchos documentos, porque es silencioso hasta que no lo es. A partir de .NET 11, System.IO.Compression valida el checksum CRC32 cuando lees una entrada ZIP, y lanza InvalidDataException si el checksum almacenado no coincide con los datos. Anteriormente, una entrada corrupta o manipulada se leía directamente sin quejas.

Ese es un cambio realmente bueno, quieres saber cuándo un archivo está mal, pero si tu aplicación ingiere archivos ZIP de usuarios, socios o un antiguo depósito de almacenamiento, el código que "funcionó" durante años puede comenzar a lanzar excepciones. La solución es pequeña: envuelve tu lectura en un try-catch para InvalidDataException y decide cómo quieres manejar un archivo corrupto. Mejor atraparlo a propósito que descubrirlo en producción.

El engañoso: TryParse ahora puede lanzar

Todo desarrollador de .NET ha interiorizado que TryParse nunca lanza, devuelve un bool. En .NET 11, DateOnly.TryParse, TimeOnly.TryParse, y sus hermanos TryParseExact rompen ese hábito ligeramente: pasa un valor DateTimeStyles inválido o un especificador de formato incorrecto y ahora lanzan ArgumentException en lugar de devolver false silenciosamente. Si tus cadenas de formato y estilos están codificados y son válidos, nada cambia. Si se calculan en tiempo de ejecución o provienen de la entrada del usuario, ese es un nuevo camino de excepción a cubrir.

Verifica solo si es tu mundo

El resto son más específicos, y se agrupan por donde se encuentran:

  • ASP.NET Core. Las antiguas API de Blazor marcadas como obsoletas hace años ya no se compilan. Kestrel es más estricto con los encabezados HTTP malformados. Y si tu cadena de conexión SQL usa autenticación Entra ID (Active Directory), ahora necesitas el paquete Microsoft.Data.SqlClient.Extensions.Azure, esto también afecta a los usuarios de EF Core SQL Server.
  • Extensiones y alojamiento. Los servicios de trabajador fallan más fuerte: si un BackgroundService lanza, el host también lanza, así que prueba tu ruta de inicio.
  • Bibliotecas principales. Math.Round y los números complejos se volvieron más correctos según los estándares, lo que solo importa si las pruebas esperan los valores antiguos.
  • Construcción y herramientas. VSTest elimina Newtonsoft.Json, los paquetes de plantillas eliminan netstandard2.0. Estos aparecen como errores de compilación, por lo que se anuncian a sí mismos.
  • Plataforma. Los requisitos mínimos de CPU aumentaron, .NET MAUI necesita Android API 24, y la obtención de certificados TLS del lado del servidor está desactivada por defecto. Sabrás si esos son para ti.

Una cosa de la que no tendrás que preocuparte

Mientras auditas dependencias para la preparación de .NET 11, tus herramientas de documentos no deberían estar en la lista. Las bibliotecas de Iron Suite son .NET administrado puro y ya funcionan en .NET 11 a través de .NET Framework, por lo que IronPDF, IronXL, y el resto de la suite se mueven con tu aplicación en lugar de bloquearla. Vale la pena mencionarlo dado que el cambio de ZIP mencionado anteriormente vive justo al lado del tipo de código de manejo de archivos que estas bibliotecas reemplazan, si tienes un manejo de documentos o archivos hecho a mano, una migración es un momento natural para pasar esa parte a una biblioteca que ya sigue cada lanzamiento de .NET.

Para la lista completa, incluidos los cambios de ASP.NET Core que viven en su propia página, la referencia de cambios importantes de Microsoft .NET 11 es la fuente para marcar. Actualizaremos esta publicación a medida que esa lista crezca, ya que aún se está completando.