Es posible que se produzcan cambios importantes al migrar código

Los cambios que afectan a la compatibilidad, también conocidos como cambios disruptivos, se producirán entre versiones de .NET. Los cambios son impactantes al migrar de .NET Framework a .NET debido a que algunas tecnologías no están disponibles. Además, puede encontrar cambios importantes simplemente porque .NET es una tecnología multiplataforma y .NET Framework no lo está.

Microsoft se esfuerza por mantener un alto nivel de compatibilidad entre las versiones de .NET, por lo que mientras se producen cambios importantes, se consideran cuidadosamente.

Antes de actualizar las versiones principales, compruebe la documentación de cambios importantes para ver los cambios que podrían afectarle.

Cambios que afectan a la compatibilidad

Hay varios tipos de cambios que los autores de bibliotecas pueden realizar que afecten a la compatibilidad, entre los que se incluyen:

• Modificaciones en el contrato público
• Cambios de comportamiento
• Compatibilidad con plataformas
• Cambios de implementación internos
• Cambios en el código

Para obtener más información sobre el tipo de cambios permitidos o no permitidos, consulte Cambio de reglas de compatibilidad.

Tipos de compatibilidad

La compatibilidad hace referencia a la capacidad de compilar o ejecutar código en una implementación de .NET distinta de la con la que se desarrolló originalmente el código.

Hay seis formas diferentes de que un cambio puede afectar a la compatibilidad:

• Cambios de comportamiento
• Compatibilidad binaria
• Compatibilidad de origen
• Compatibilidad en tiempo de diseño
• Compatibilidad retroactiva
• Compatibilidad con versiones posteriores

Para obtener más información, consulte Cómo pueden afectar los cambios de código a la compatibilidad.

Identificar cambios decisivos

Los cambios que afectan a la compatibilidad se documentan. Revise estos cambios antes de migrar el código de .NET Framework a .NET o actualícelo a una versión más reciente de .NET. Para obtener una lista de estos cambios importantes, consulte Cambios importantes para la migración de .NET Framework a .NET Core.