Tutorial: Convertir un proyecto web de Visual Studio 2002 ó 2003 en un proyecto de aplicación web de Visual Studio 2008

Actualización: noviembre 2007

En este tutorial se describe cómo convertir un proyecto web de Microsoft Visual Studio .NET 2002 o Visual Studio .NET 2003 a Visual Studio 2008. El modelo de proyectos de aplicación web de Visual Studio 2008 es como el modelo de proyectos de aplicación web de Visual Studio 2005. Por consiguiente, el proceso de conversión es similar. Para obtener más información sobre proyectos de aplicación web, vea Información general sobre proyectos de aplicaciones web.

También puede convertir un proyecto web de Visual Studio .NET en un proyecto de sitio web de Visual Studio 2008. Sin embargo, el enfoque admitido es la conversión a un proyecto de aplicación web, y ofrece la comodidad de disponer de herramientas para ayudar en la conversión. Por ejemplo, al realizar la conversión a un proyecto de aplicación web de Visual Studio 2008, puede utilizar el Asistente para conversión de Visual Studio para automatizar parte del proceso. Para obtener información sobre cómo convertir un proyecto web de Visual Studio .NET en un sitio web de Visual Studio 2008, vea Common Web Project Conversion Issues and Solutions.

En la conversión de un proyecto web de Visual Studio 2002 o 2003 en un proyecto de aplicación web de Visual Studio 2008 hay dos partes implicadas. Son las siguientes:

Convertir el proyecto. Puede utilizar el Asistente para conversión de Visual Studio para realizar la conversión inicial de los archivos de proyecto y Web.config. Después, puede utilizar el comando Convertir a aplicación Web para actualizar los archivos y la estructura del proyecto.

Actualizar la versión de .NET Framework del proyecto. Debe actualizar la versión de .NET Framework del proyecto a .NET Framework 2.0 SP1 o a .NET Framework 3.5. La actualización de la versión de .NET Framework es necesaria porque Visual Studio 2008 no puede tener como destino versiones anteriores de .NET Framework. Esta actualización se puede realizar durante la conversión del proyecto, mediante el Asistente para conversión. O bien, puede actualizar la versión de .NET Framework después de convertir el proyecto.

Nota:
La versión de .NET Framework de un proyecto se puede cambiar manualmente. Para ello, en Visual Studio, abra las páginas de propiedades del proyecto, haga clic en la ficha Aplicación y, a continuación, seleccione una nueva versión en la lista Versión de .NET Framework de destino.

En este tutorial se muestran las siguientes tareas:

Abrir el proyecto de Visual Studio .NET en Visual Studio 2008 y crear una copia de seguridad de los archivos de proyecto.
Actualizar la versión de .NET Framework de destino del proyecto.
Convertir el archivo de proyecto y el archivo Web.config.
Convertir los archivos de código de ASP.NET.
Probar el proyecto convertido.

Requisitos previos

Para completar este tutorial, necesitará:

Visual Studio 2008.
Un proyecto de sitio web creado en la versión 2002 o 2003 de Visual Studio .NET que se compila y se ejecuta sin errores.

Convertir el proyecto y actualizar la versión de .NET Framework

Para comenzar, abra el proyecto en Visual Studio 2008, lo que inicia la conversión. Se le ofrece la oportunidad de hacer un copia de seguridad del proyecto antes de convertirlo.

Nota:
Se recomienda encarecidamente realizar una copia de seguridad del proyecto. La conversión actúa en los archivos de proyecto originales, que no se podrán recuperar si la conversión no finaliza correctamente.

Para convertir el proyecto y realizar una copia de seguridad de los archivos

En Visual Studio 2008, en el menú Archivo, haga clic en Abrir y, a continuación, en Proyecto.

Aparecerá el cuadro de diálogo Abrir proyecto.
Vaya a la carpeta que contiene el archivo del proyecto o la solución correspondiente al proyecto de Visual Studio .NET, seleccione el archivo y, a continuación, haga clic en Abrir.

Nota:

Asegúrese de abrir el proyecto utilizando el comando Abrir proyecto. Si utiliza el comando Abrir sitio Web, el proyecto se convertirá al formato de proyecto de sitio web.

El Asistente para conversión se abre y le pregunta si desea crear una copia de seguridad antes de convertir el proyecto.
Para crear la copia de seguridad, haga clic en Sí.
Haga clic en Examinar, seleccione la carpeta donde se debe crear la copia de seguridad y, a continuación, haga clic en Siguiente.

Nota:
Asegúrese de abrir el proyecto utilizando el comando Abrir proyecto. Si utiliza el comando Abrir sitio Web, el proyecto se convertirá al formato de proyecto de sitio web.

Haga clic en Finalizar.

La copia de seguridad se inicia.

Nota:
Podría haber retrasos significativos a medida que el Asistente para conversión copia archivos, sin indicación de actualizaciones ni del progreso. Espere hasta que el proceso finalice antes de continuar.

Cuando finaliza la conversión, el asistente solicita la actualización de la versión de destino de .NET Framework para el proyecto.

Para actualizar a .NET Framework 3.5, haga clic en Sí. Para actualizar el proyecto para destinarlo a .NET Framework 2.0 SP1, haga clic en No.

Se recomienda mantener seleccionada la casilla donde se pregunta si desea actualizar todos los sitios web de la solución.

Si actualiza a .NET Framework 3.5, el archivo Web.config del proyecto se modifica a la vez que el archivo de proyecto.

Una vez terminadas la actualización y la conversión, se muestra un mensaje que indica que ha completado el primer paso de la conversión del proyecto.
Haga clic en Aceptar.

El asistente muestra información de estado sobre la conversión.
Haga clic en Cerrar.

Probar el proyecto convertido

Una vez finalizada la conversión, puede probar el proyecto para asegurarse de que funciona. Esto también ayudará a identificar el código del proyecto que se debe actualizar.

Para comprobar que el proyecto se ejecuta

Si sabe que se requieren cambios para el código que se va a ejecutar con la nueva versión de .NET Framework, realice estos cambios.
En el menú Generar, haga clic en Generar.

Cualquier referencia que falte u otros problemas de compilación del proyecto aparecen en la ventana Lista de errores. Los problemas más probables son que falten referencia de ensamblado o problemas con tipos generados dinámicamente.
En el Explorador de soluciones, haga clic con el botón secundario en la página web que se utilizará para iniciar la aplicación y, a continuación, haga clic en Establecer como página de inicio.
En el menú Depurar, haga clic en Iniciar depuración.

Si no está habilitada la depuración, se muestra el cuadro de diálogo Depuración no habilitada. Seleccione la opción para agregar un archivo Web.config con depuración habilitada y haga clic en Aceptar.
Compruebe que el proyecto convertido se ejecuta según lo previsto.

No continúe con el proceso de conversión hasta que se resuelvan todos los errores en tiempo de ejecución y compilación.

Convertir archivos de código de ASP.NET

Los archivos de páginas web ASP.NET y los archivos de controles de usuario de Visual Studio 2008 que utilizan el modelo de código subyacente tienen asociado un archivo de diseñador. Los archivos recién convertidos tendrán asociado un archivo de código subyacente, pero no un archivo de diseñador. Por consiguiente, el paso siguiente es generar los archivos de diseñador.

Nota:
Sólo las páginas web ASP.NET y los controles de usuario que tienen su código en un archivo de código independiente necesitan un archivo de diseñador independiente. Para las páginas que tienen código en línea y ningún archivo de código asociado, no se generará ningún archivo de diseñador.

Para convertir los archivos de código de ASP.NET

En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nodo de proyecto y, a continuación, haga clic en Convertir a aplicación Web.

Los archivos se convierten.
Compruebe que los archivos de código convertidos tienen un archivo de código y un archivo de diseñador.
Genere y ejecute el proyecto para comprobar los resultados de la conversión.