Introducción a la migración incremental de ASP.NET a ASP.NET Core

Para una migración grande, se recomienda configurar una aplicación de ASP.NET Core que procura la aplicación .NET Framework original. La nueva aplicación habilitada para la procuración se muestra en la siguiente imagen:

Para comprender cómo este enfoque es útil en el proceso de migración, consulte Migración incremental ASP.NET para ASP.NET Core. En el resto de este artículo se proporcionan los pasos para continuar con una migración incremental.

Configurar el proyecto ASP.NET Core

Para obtener aplicaciones de ASP.NET MVC y de API web, vea Más información sobre cómo actualizar desde ASP.NET MVC y API web a ASP.NET Core MVC). Para obtener aplicaciones de ASP.NET Framework Web Forms Apps, vea Más información sobre cómo actualizar de ASP.NET Web Forms a ASP.NET Core).

Actualizar las bibliotecas auxiliares

Si tiene bibliotecas auxiliares en la solución que necesitará usar, se deben actualizar a .NET Standard 2.0, si es posible. Upgrade Assistant es una excelente herramienta para esto. Si las bibliotecas no pueden tener como destino .NET Standard, puede tener como destino .NET 6 o posterior junto con el destino de .NET Framework en el proyecto original o en un nuevo proyecto junto con el original.

Los adaptadores se pueden usar en estas bibliotecas para habilitar la compatibilidad con el uso de System.Web.HttpContext en las bibliotecas de clases. Para habilitar el uso System.Web.HttpContext en una biblioteca:

1. Elimine la referencia a System.Web en el archivo de proyecto
2. Agregue el paquete Microsoft.AspNetCore.SystemWebAdapters
3. Habilite la compatibilidad con múltiples versiones y agregue un destino de .NET 6 o posterior, o bien convierta el proyecto en .NET Standard 2.0.
4. Asegúrese de que la plataforma de destino admite .NET Core. Se pueden usar varios destinos si .NET Standard 2.0 no es suficiente

Este paso puede requerir un número de proyectos que cambien en función de la estructura de la solución. Upgrade Assistant puede ayudarle a identificar cuáles deben cambiar y automatizar una serie de pasos en el proceso.

Habilitar la compatibilidad con sesiones

La sesión es una característica de uso frecuente de ASP.NET que comparte el nombre con una característica en ASP.NET Core cuyas API son muy diferentes. Consulte la documentación sobre la compatibilidad con la sesión.

Habilitar la compatibilidad con la autenticación compartida

Es posible compartir la autenticación entre la aplicación ASP.NET original y la nueva aplicación de ASP.NET Core mediante la característica de autenticación remota de adaptadores System.Web. Esta característica permite a la aplicación ASP.NET Core aplazar la autenticación a la aplicación ASP.NET. Consulte la documentación sobre la conexión de aplicaciones remotas y la autenticación remota para saber más.

Guía de uso general

Hay varias diferencias entre ASP.NET y ASP.NET Core que los adaptadores pueden ayudar a actualizar. Sin embargo, hay algunas características que requieren una participación, ya que incurren en algún costo. También hay comportamientos que no se pueden adaptar. Consulte la guía de uso para obtener una lista de estos.