Tutorial: Convertir un proyecto web de Visual Studio .NET 2003 en un proyecto de aplicación web de Visual Studio

Artículo
10/22/2014

Actualización: noviembre 2007

Si convierte el proyecto web de Visual Studio .NET 2003 en un proyecto de aplicación web de Visual Studio 2008, puede aprovechar las características de Visual Studio 2008. Esto incluye refactorización, diagramas de clase, desarrollo de pruebas y genéricos. El modelo de proyecto de aplicación web también ofrece todas las características de ASP.NET 2.0 y posterior. Estas incluyen páginas maestras, controles de datos, controles de pertenencia e inicio de sesión, administración de funciones, elementos web, personalización, navegación por el sitio y temas.

El modelo de proyecto de aplicación web de Visual Studio 2008 es muy similar al modelo de proyecto disponible para las aplicaciones de Visual Studio .NET 2003. Esto puede resultar útil si convierte un proyecto web de Visual Studio .NET 2003 a Visual Studio 2008. Para obtener más información sobre nuevas características, vea Lo nuevo en ASP.NET y desarrollo web.

Nota:
Puede crear proyectos de aplicación web ASP.NET usando Visual Studio o Visual Web Developer Express.

En este tutorial se explica cómo convertir un proyecto web existente de Microsoft Visual Studio .NET 2003 en un proyecto de aplicación web en Visual Studio 2008. El modelo de proyecto de aplicación web utiliza el mismo enfoque conceptual que un proyecto web de Visual Studio .NET 2003. Esto incluye un archivo de proyecto para incluir y excluir archivos y la compilación en un ensamblado único. Para obtener más información, vea Conversión de proyectos web de Visual Studio .NET.

Nota:
Para convertir un sitio web que utiliza Microsoft Office FrontPage 2003 en un proyecto de aplicación web, en primer lugar debe convertir el sitio web de FrontPage en un proyecto de sitio web de Visual Studio 2008. A continuación, se convierte el proyecto de sitio web en un proyecto de aplicación web. Para obtener más información, vea Tutorial: Convertir un proyecto de sitio web en un proyecto de aplicación web en Visual Studio.

Para convertir un sitio web que utiliza Microsoft Office FrontPage 2003 en un proyecto de aplicación web, en primer lugar debe convertir el sitio web de FrontPage en un proyecto de sitio web de Visual Studio 2008. A continuación, se convierte el proyecto de sitio web en un proyecto de aplicación web. Para obtener más información, vea Tutorial: Convertir un proyecto de sitio web en un proyecto de aplicación web en Visual Studio.

Entre las tareas ilustradas en este tutorial se incluyen las siguientes:

Abrir y comprobar el proyecto web de Visual Studio .NET 2003.
Realizar una copia de seguridad del proyecto web de Visual Studio .NET 2003.
Convertir el proyecto web de Visual Studio .NET 2003 a Visual Studio 2008.
Comprobar el proyecto de aplicación web en Visual Studio 2008.
Convertir las clases de código subyacente en clases parciales.
Examinar y resolver los problemas de compatibilidad con XHTML.

Requisitos previos

Para poder completar este tutorial, necesitará:

Visual Studio .NET 2003
Visual Studio 2008 o Visual Studio 2005 Service Pack 1 (SP1) o Visual Web Developer Express
.NET Framework versión 2.0

Abrir y comprobar el proyecto web de Visual Studio .NET 2003

Antes de convertir un proyecto, debe comprobar que funciona correctamente. Esto evitará errores durante la conversión.

Para abrir y comprobar el proyecto web de Visual Studio .NET 2003

Abra Visual Studio .NET 2003.
En el menú Archivo, haga clic en Abrir archivo y, a continuación, escriba o busque el archivo .sln correspondiente a la solución que desea comprobar.

Nota:

En Visual Studio .NET 2003, los archivos que componen el proyecto se incluyen en un archivo de solución (.sln).
En el menú Proyecto, haga clic en Generar solución.
En el menú Depurar, haga clic en Iniciar.
Compruebe que el proyecto se ejecuta según lo previsto.

Nota:
En Visual Studio .NET 2003, los archivos que componen el proyecto se incluyen en un archivo de solución (.sln).

Realizar una copia de seguridad del proyecto web de Visual Studio .NET 2003

Se recomienda realizar una copia de seguridad de la solución y los archivos de proyecto de Visual Studio .NET 2003 antes de iniciar el proceso de conversión. Si se produce algún problema durante la conversión, podrá recuperar la solución de Visual Studio .NET 2003.

Para hacer un copia de seguridad del proyecto, copie el proyecto en Visual Studio .NET 2003.

Para hacer una copia de seguridad del proyecto web de Visual Studio .NET 2003 antes de la conversión

Abra Visual Studio .NET 2003.
En el menú Archivo, haga clic en Abrir archivo y, a continuación, escriba o busque el archivo .sln correspondiente a la solución cuya copia de seguridad desea realizar.
En el menú Proyecto, haga clic en Copiar proyecto.
En el cuadro Copiar proyecto, seleccione Carpeta de proyecto de destino.
Seleccione una opción de Método de acceso al Web. Puede utilizar FrontPage o Recurso compartido de archivos para copiar los archivos.
Seleccione la opción Todos los archivos de la carpeta de proyecto de origen y, a continuación, haga clic en Aceptar.

Convertir el proyecto web de Visual Studio .NET 2003 a Visual Studio 2008

Visual Studio 2008 convierte la solución de Visual Studio .NET 2003 y los archivos de proyecto para utilizar el formato de Microsoft Build Engine (MSBuild), que es el formato de archivo de proyecto en Visual Studio 2008.

Como parte del proceso de conversión, Visual Studio 2008 genera un archivo de registro basado en XML que proporciona un resumen de la conversión y marca los problemas que hayan podido surgir. De forma predeterminada, el archivo de registro de conversión se guarda en el mismo directorio que el archivo .sln. Si surgen problemas durante la compilación del proyecto convertido, podrá consultar el archivo de registro de la conversión.

Para convertir el proyecto web a Visual Studio 2008

En Visual Studio .NET 2003, cierre el archivo de solución.
Abra Visual Studio 2008.
En el menú Archivo, haga clic en Abrir archivo y, a continuación, escriba o busque el archivo .sln correspondiente a la solución que desea convertir.

Se abre el Asistente para conversión de Visual Studio 2008.
Haga clic en Siguiente, siga las instrucciones del asistente y, a continuación, haga clic en Finalizar.

Comprobar el proyecto de aplicación web en Visual Studio 2008

Una vez convertidos los archivos de proyecto y la solución al formato de Visual Studio 2008, debe comprobar que la aplicación se genera sin errores y se ejecuta según lo previsto.

Para comprobar el proyecto de aplicación web en Visual Studio 2008

En Visual Studio 2008, en el menú Archivo, haga clic en Abrir archivo y, a continuación, escriba o busque el archivo .sln correspondiente a la solución que desea comprobar.
En el menú Proyecto, haga clic en Generar solución.
En el menú Depurar, haga clic en Iniciar.
Compruebe que el proyecto de aplicación web se ejecuta según lo previsto.

Errores y advertencias comunes

A continuación se indican los tipos más comunes de errores o advertencias que surgen durante el proceso de conversión:

Conflictos con nombres que se introdujeron en .NET Framework versión 2.0.
Advertencias sobre miembros obsoletos.
Problemas que tienen lugar al ejecutar la aplicación web.

Para corregir los conflictos de denominación, puede quitar la ambigüedad si completa totalmente los nombres existentes con un espacio de nombres. También puede cambiar el nombre de los tipos y miembros en conflicto para que no se produzca este problema. Para obtener más información sobre los conflictos al asignar nombres, vea Información general sobre la migración a ASP.NET 2.0 e Instrucciones de nomenclatura para los espacios de nombres.

Si aparece una advertencia sobre el uso de miembros obsoletos, el mensaje de advertencia suele sugerir miembros alternativos que se pueden utilizar. En ese caso, puede continuar utilizando los miembros obsoletos. Sin embargo, los miembros se quitarán en la siguiente versión principal de .NET Framework. Por consiguiente, se recomienda quitar los miembros y sustituirlos por las alternativas sugeridas.

Si aparece un error que indica que se deniega una lista de directorios durante la ejecución de la aplicación web, puede que el directorio virtual de la aplicación web no permita que se muestre su contenido. Para corregir este problema, en el Explorador de soluciones, haga clic con el botón secundario en la página de inicio de la aplicación y, a continuación, haga clic en Establecer como página de inicio. De esta forma se asegura de que se invoca la página correcta al ejecutar la aplicación.

Convertir las clases de código subyacente en clases parciales

En Visual Studio 2008, el proyecto de aplicación web utiliza clases parciales para el código que genera Visual Studio. Estas clases se almacenan en un archivo independiente del archivo de código subyacente. De manera predeterminada, el Asistente para conversión de Visual Studio 2008 no crea un archivo *.designer.cs ni un archivo *.designer.vb para las páginas web (archivos .aspx) ni los controles de usuario (archivos .ascx). En su lugar, el código tendrá la misma apariencia y funcionará igual que en Visual Studio .NET 2003.

Nota:
El Asistente para conversión de Visual Studio 2008 realizará el menor número de cambios posible en los archivos de código durante el proceso de conversión. Esto ayuda a crear una conversión a un proyecto de aplicación web en Visual Studio 2008 sin problemas.

Se puede conservar el código en el formato de Visual Studio .NET 2003. En este caso, debe actualizar manualmente las declaraciones de los campos de control en los archivos de código subyacente de la misma forma que se realizaba en Visual Studio .NET 2003. Sin embargo, si desea aprovechar la capacidad de mantener las declaraciones de campos en el código generado, debe actualizar las páginas y los controles de modo que utilicen el modelo de clase parcial. Las clases parciales facilitan la organización del código generado y del código personalizado de los archivos de código subyacente. Para obtener más información, vea Partial (Visual Basic) y Tipo parcial (Referencia de C#).

Para convertir el código de modo que utilice el modelo de clase parcial

Asegúrese de que el código se compila sin errores.

En el Explorador de soluciones, haga clic con el botón secundario en el nombre de proyecto y, a continuación, haga clic en Convertir en aplicación web.

Este comando recorre en iteración cada página y control de usuario del proyecto. Mueve todas las declaraciones de control a un archivo .designer.cs o designer.vb. También agrega declaraciones de controlador de eventos al marcado del control de servidor de los archivos .aspx y .ascx.

Nota:
Puede utilizar el comando Convertir en aplicación web en páginas individuales. Ejecute primero el comando en algunas páginas para ver los cambios realizados en cada página antes de aplicar los cambios a la aplicación completa.

No puede deshacer el efecto del comando Convertir en aplicación web. El mejor método para restaurar los cambios consiste en restaurar una copia de seguridad del proyecto de Visual Studio .NET 2003 y, a continuación, volver a ejecutar la conversión de Visual Studio 2008 anteriormente descrita.

Una vez finalizado el proceso, compruebe en la ventana Lista de tareas si se muestra algún error de conversión.

Si se muestran errores en la Lista de tareas, haga clic con el botón secundario en la página correspondiente en el Explorador de soluciones. Seleccione Ver código y Ver archivo gen. código para examinar el código y resolver los problemas.

Nota:
Los errores y advertencias que aparecen en la ventana Lista de tareas se conservan de una sesión a otra de Visual Studio. Después de corregir los errores mostrados en la ventana, podrá borrar los elementos de la lista de tareas.

Vuelva a compilar el proyecto para asegurarse de que se compila sin errores.

A partir de este momento, cuando se agreguen nuevas páginas al proyecto web, éstas utilizarán de forma predeterminada la plantilla de clase parcial. Para obtener más información, vea Información general sobre la migración a ASP.NET 2.0.

Examinar y resolver los problemas de compatibilidad con XHTML

De manera predeterminada, Visual Studio 2008 genera y valida el marcado conforme con XHTML. Esto ayuda a generar aplicaciones web compatibles con los estándares y a minimizar los problemas de representación específicos de cada explorador. De forma predeterminada, Visual Studio .NET 2003 no genera marcado conforme con XHTML. Por tanto, tras la conversión de la aplicación web a Visual Studio 2008, es posible que haya problemas de validación y representación con las páginas creadas en Visual Studio .NET 2003.

Nota:
Los errores de validación son sólo informativos y se marcan como advertencias. Los errores de validación no impiden que se ejecute la página.

Si desea ver los errores de validación HTML como en Visual Studio .NET 2003, cambie la configuración de la validación HTML de XHTML Transitional a Internet Explorer 6.0. Internet Explorer 6.0 era la configuración predeterminada en Visual Studio .NET 2003 para la validación HTML. Para obtener más información, vea Cómo: Seleccionar esquemas de validación para la edición de HTML en Visual Web Developer.

Asimismo, puede agregar la siguiente sección al archivo Web.config del proyecto, para que ASP.NET represente el marcado heredado (no conforme con XHTML) de los controles de servidor:

<system.Web>
  <xhtmlConformance mode="Legacy" />
</system.Web>

De esta forma se evitan las pequeñas diferencias de representación que pueden aparecer entre páginas que se muestran con ASP.NET 1.1 y ASP.NET 2.0. Tenga en cuenta que sólo debe utilizar el cambio de modo xhtmlConformance para solucionar problemas de conversión. Si el proyecto de aplicación web se ejecuta correctamente, quite el valor de configuración heredada. Para obtener más información, vea ASP.NET y XHTML e Información general sobre la migración a ASP.NET 2.0.

Vea también

Compartir a través de