Actualización de una aplicación de escritorio de Windows Forms de .NET Framework a .NET 8

En este artículo se describe cómo actualizar una aplicación de escritorio de Windows Forms a .NET 8 mediante el Asistente para actualización. Aunque Windows Forms se ejecuta en .NET, una tecnología multiplataforma, Windows Forms sigue siendo un marco de trabajo solo de Windows. Los siguientes tipos de proyecto relacionados con Windows Forms se pueden actualizar con el asistente para actualización de .NET:

• Proyecto de Windows Forms
• Biblioteca de controles
• Biblioteca de .NET

Requisitos previos

• Sistema operativo Windows.
• Descargue y extraiga la aplicación de demostración que se usa con este artículo.
• Visual Studio 2022, versión 17.8 o posterior, para tener como destino .NET 8.
• Extensión del Asistente para actualización de .NET para Visual Studio.

Actualización de las dependencias en primer lugar

Si va a actualizar varios proyectos, comience con proyectos que no tengan dependencias. En el ejemplo Juego coincidente, el proyectoMatchingGame depende de la bibliotecaMatchingGame.Logic, por lo que MatchingGame.Logic debería actualizarse primero.

Sugerencia

Asegúrese de tener una copia de seguridad del código, como en el control de código fuente o una copia.

Siga estos pasos para actualizar un proyecto en Visual Studio:

1. Haga clic con el botón derecho en el proyecto MatchingGame.Logic en la ventana Explorador de soluciones y seleccione Actualizar:

   

   Se abre una nueva pestaña que le pide que elija el tipo de actualización que desea realizar.

2. Seleccione Actualizar proyecto a una versión más reciente de .NET.

   

3. Seleccione Actualización local del proyecto.

   

4. A continuación, seleccione la plataforma de destino. En función del tipo de proyecto que está actualizando, se le presentan diferentes opciones. .NET Standard 2.0 puede usarse tanto en .NET Framework como en .NET. Esta es una buena opción si la biblioteca no depende de una tecnología de escritorio como Windows Forms. Sin embargo, las versiones más recientes de .NET proporcionan muchas mejoras de lenguaje y compilador a través de .NET Standard.

   Seleccione .NET 8.0 y después, seleccione Siguiente.

   

5. Se muestra un árbol con todos los artefactos relacionados con el proyecto, como archivos de código y bibliotecas. Puede actualizar artefactos individuales o todo el proyecto, que es el valor predeterminado. Seleccione Actualizar selección para iniciar la actualización.

6. Una vez finalizada la actualización, se muestran los resultados:

   

   Los artefactos con un círculo verde sólido se actualizaron mientras se omitían círculos verdes vacíos. Los artefactos omitidos significan que el asistente de actualización no encontró nada que actualizar.

Ahora que se actualiza la biblioteca auxiliar de la aplicación, actualice la aplicación principal.

Actualización del proyecto principal

Una vez actualizadas todas las bibliotecas auxiliares, se puede actualizar el proyecto de aplicación principal. Con la aplicación de ejemplo, solo hay un proyecto de biblioteca que se va a actualizar, que se actualizó en la sección anterior.

1. Haga clic con el botón derecho en el proyecto MatchingGame en la ventana Explorador de soluciones y seleccione Actualizar:
2. Seleccione Actualizar proyecto a una versión más reciente de .NET.
3. Seleccione Actualización local del proyecto como modo de actualización.
4. Seleccione .NET 8.0 para la plataforma de destino y seleccione Siguiente.
5. Deje todos los artefactos seleccionados y seleccione Actualizar selección.

Una vez completada la actualización, se muestran los resultados. Observe cómo el proyecto de Windows Forms tiene un símbolo de advertencia. Expanda ese elemento y se muestra más información sobre ese paso:

Observe que el componente de actualización del proyecto menciona que la fuente predeterminada ha cambiado. Dado que la fuente puede afectar al diseño del control, debe comprobar todos los formularios y controles personalizados del proyecto para asegurarse de que la interfaz de usuario está organizada correctamente.

Generación de una compilación limpia

Una vez actualizado el proyecto principal, limpie y compílelo.

1. Haga clic con el botón derecho en el proyecto MatchingGame en la ventana del Explorador de soluciones y seleccione Limpiar.
2. Haga clic con el botón derecho en el proyecto MatchingGame en la ventana Explorador de soluciones y seleccione Compilar.

Si la aplicación encontró algún error, puede encontrarlos en la ventana Lista de errores con una recomendación sobre cómo corregirlas.

El proyecto Muestra de Windows Forms Matching Game se ha actualizado a .NET 8.

Contenido relacionado

• Portabilidad de .NET Framework a .NET.

  La guía de portabilidad proporciona información general sobre lo que debe tener en cuenta al migrar el código de .NET Framework a .NET. La complejidad de los proyectos determina la cantidad de trabajo que se realizará después de la migración inicial de los archivos del proyecto.

• Modernización después de actualizar a .NET desde .NET Framework.

  El mundo de .NET ha cambiado mucho desde .NET Framework. Este vínculo proporciona información sobre cómo modernizar la aplicación después de actualizarla.