Requisitos previos para migrar código

Realice los cambios necesarios para compilar y ejecutar una aplicación .NET antes de comenzar el trabajo para portar el código. Estos cambios se pueden realizar al compilar y ejecutar una aplicación de .NET Framework.

Importante

El Asistente de Actualización de .NET está oficialmente obsoleto. Utilice el agente de chat de modernización de Copilot de GitHub, que se incluye con Visual Studio 2026 y Visual Studio 2022 17.14.16 o posterior. Este agente analiza los proyectos y las dependencias, genera un plan de migración paso a paso con recomendaciones de destino y correcciones de código automatizadas, y confirma cada cambio para poder validar o revertir. Automatiza las tareas comunes de portabilidad, actualizando archivos de proyecto, reemplazando las API en desuso y resolviendo problemas de compilación, por lo que puede modernizarse más rápido con menos esfuerzo manual.

Actualización a las herramientas necesarias

Actualice a una versión de MSBuild/Visual Studio que admita la versión de .NET que va a tener como destino. Consulte Relación de control de versiones entre el SDK de .NET, MSBuild y VS para obtener más información.

Actualización de la versión de destino de .NET Framework

Recomendamos que oriente su aplicación de .NET Framework hacia la versión 4.7.2 o posterior. Esto garantiza la disponibilidad de las alternativas de API más recientes para los casos en los que .NET Standard no admite las API existentes.

Para cada uno de los proyectos que desea migrar, haga lo siguiente en Visual Studio:

  1. Haga clic con el botón derecho en el proyecto y seleccione Propiedades.
  2. En la lista desplegable Plataforma de destino, seleccione .NET Framework 4.7.2.
  3. Vuelva a compilar el proyecto.

Dado que los proyectos tienen como destino .NET Framework 4.7.2, use esa versión de .NET Framework como base para migrar código.

Cambiar al formato PackageReference

Convierta todas las referencias al formato PackageReference .

Conversión al formato de proyecto de estilo SDK

Convierta los proyectos en el formato de estilo SDK.

Actualización de las dependencias

Actualice las dependencias a su versión más reciente disponible y a la versión de .NET Standard siempre que sea posible.

Pasos siguientes