Compartir a través de

Conversión de la configuración de proyectos Web

  • Artículo

Actualización: noviembre 2007

Visual Studio no conserva los archivos de proyecto para el desarrollo Web, por lo que el proceso de conversión debe transferir las opciones necesarias de las soluciones y los proyectos a un formato de Visual Studio. Por ejemplo, el proceso de conversión mueve determinados valores de configuración del proyecto al archivo Web.config, que en Microsoft Visual Studio 2005 se ha ampliado para que pueda almacenar más información que en las versiones anteriores de Visual Studio .NET.

Muchas de las opciones mantenidas en Visual Studio .NET no son aplicables a Visual Studio 2005, por lo que no se convierten. Por ejemplo, las opciones del proyecto para el modo de acceso Web (archivos compartidos o FrontPage) y para los valores predeterminados del diseñador no se aplican en Visual Studio, por lo que no se convierten. Las opciones del proyecto que tienen valores predeterminados tampoco se convierten, es decir, Visual Studio no genera una nueva opción con el valor predeterminado.

Proyectos con varias configuraciones

Si un proyecto contiene varias configuraciones (compilación de depuración, compilación de lanzamiento, etc.), la conversión sigue esta lógica:

  • Si el proyecto contiene sólo configuraciones de depuración y de lanzamiento, la configuración de depuración se convierte a Visual Studio 2005.

  • Si existen configuraciones adicionales, Visual Studio le solicita las opciones de configuración que se deben convertir a Visual Studio 2005.

Referencias

Las referencias a los ensamblados de la carpeta Bin del proyecto no se tienen que convertir; los sitios Web de Visual Studio seleccionan automáticamente las referencias que se deben codificar en la carpeta Bin. Si el proyecto contiene una referencia a un ensamblado de la caché de ensamblados global, la referencia se traslada al archivo Web.config con el formato siguiente.

<compilation>
  <assemblies>
    <add assembly="System.Messaging" />
  </assemblies>
</compilation>

Las referencias de ensamblado no se convierten si se hace referencia al ensamblado de forma predeterminada en ASP.NET (por ejemplo, System.Drawing).

En Visual Studio .NET, los ensamblados a los que se hace referencia (por ejemplo, los ensamblados a los que se hace referencia fuera de la solución en la que se encuentra el proyecto Web) pueden tener la propiedad CopyLocal establecida en el valor true, lo que actualizaría automáticamente el ensamblado al que se hace referencia. En Visual Studio 2005, este comportamiento es reemplazado por la creación de un archivo de actualización en la carpeta Bin. El archivo de actualización contiene la ruta de acceso al ensamblado externo al que se hace referencia y lleva la extensión .refresh anexada al nombre de ensamblado.

Las referencias Web XML se convierten copiando el archivo .wsdl en el directorio App_WebReferences. El servidor proxy del servicio Web y los archivos de asignación de referencias no son necesarios en Visual Studio 2005.

Conversión de las opciones comunes

En la tabla siguiente se muestran las opciones del proyecto Propiedades comunes y se describe cómo las trata el proceso de conversión de Visual Studio.

Nota:

Se pueden ver los valores actuales de esta configuración en Visual Studio. En el Explorador de soluciones, haga clic con el botón secundario del mouse (ratón) en el proyecto, haga clic en Propiedades y, a continuación, en Propiedades comunes.

Valor

Lógica de conversión

General

Los valores no se convierten.

Configuración Web

Los valores no se convierten.

Valores predeterminados del diseñador

Los valores no se convierten.

Ruta de acceso de referencias

Los valores no se convierten.

Generar (proyectos de cliente de Visual Basic)

  • Option Explicit

    Si se establece en false, esta opción se mueve al archivo Web.config:

    <compilation explicit="false">

  • Option Strict

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compilation strict="true" />

  • Option Compare

    Si su valor es Text, esta opción se traslada al archivo Web.config:

    <compiler language="vb"

    compilerOptions="optioncompare:text" />

Importaciones (proyectos de cliente de Visual Basic)

Los valores de importación que no se importan de manera predeterminada en ASP.NET se trasladan al archivo Web.config:

<pages>

<namespaces>

<add namespace="Namespace" />

</namespaces>

</pages>

La conversión afecta sólo a los valores de importación de las páginas Web ASP.NET. Para las clases del directorio App_Code, debe agregar manualmente los valores de importación.

Conversión de las opciones de configuración

Las opciones de configuración de un proyecto pueden ser diferentes en función del lenguaje de programación que el proyecto utilice. En las tablas siguientes se muestra cómo trata el proceso de conversión de Visual Studio las opciones de configuración, en una clasificación por lenguaje.

Nota:

Se pueden ver los valores actuales de esta configuración en Visual Studio. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto, haga clic en Propiedades y, a continuación, en Propiedades de configuración.

Opciones de configuración: todos los lenguajes

En la tabla siguiente se muestran las opciones de Configuración de proyecto que aparecen en todos los tipos de proyecto y se describe cómo las trata el proceso de conversión de Visual Studio.

Opción

Lógica de conversión

Depuración

  • Habilitar depuración ASP

    La opción no se convierte.

  • Habilitar depuración ASP.NET

    La opción no se convierte.

  • Habilitar depuración sin administrar

    La opción se convierte tal cual.

  • Habilitar depuración de SQL Server

    La opción se convierte tal cual.

  • Opción Acción de inicio

    La opción se traslada a una caché de cliente por usuario.

  • Argumentos de la línea de comandos

    La opción se convierte tal cual.

  • Directorio de trabajo

    La opción se convierte tal cual.

  • Usar siempre Internet Explorer

    La opción no se convierte.

  • Habilitar depuración remota

    La opción no se convierte.

  • Equipo de depuración remoto

    La opción no se convierte.

Opciones de configuración: Visual Basic .NET

En la tabla siguiente se muestran las opciones de Configuración que aparecen en los proyectos de Visual Basic.NET y se describe cómo las trata el proceso de conversión de Visual Studio.

Opción

Lógica de conversión

Generar

  • Ruta de acceso de los resultados

    La opción no se convierte.

  • Generar información de depuración

    La configuración se mueve al archivo Web.config:

    <compilation debug="true|false" />

  • Registrar para interoperabilidad COM

    La opción no se convierte.

  • Habilitar advertencias de generación (proyectos de cliente de Visual Basic)

    La opción no se convierte. Las advertencias de generación están siempre habilitadas en Visual Studio .NET.

  • Tratar advertencias del compilador como errores (proyectos de cliente de Visual Basic)

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="vb"

    compilerOptions="warnaserror+" />

  • Definir constante DEBUG (proyectos de cliente de Visual Basic)

    La configuración se mueve al archivo Web.config:

    <compiler

    language="vb"

    compilerOptions="define:Debug" />

  • Definir constante TRACE (proyectos de cliente de Visual Basic)

    La configuración se mueve al archivo Web.config:

    <compiler

    language="vb"

    compilerOptions="define:Trace" />

  • Constantes personalizadas (proyectos de cliente de Visual Basic)

    La configuración se mueve al archivo Web.config:

    <compiler

    language="vb"

    compilerOptions="define:<list>" />

  • Documentación XML

    Si se establece su valor, esta opción se traslada al archivo Web.config:

    <compiler language="c#"

    compilerOptions="doc:<filepath>" />

  • Constantes de compilación condicional

    La configuración se mueve al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="d:<symbols>" />

  • Optimizar código

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="o" />

  • Comprobar el desbordamiento y subdesbordamiento aritmético

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="checked+" />

  • Permitir bloques de código no seguros

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="unsafe+" />

  • Nivel de advertencia

    Si su valor no es 4, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="w:<level>" />

  • Tratar advertencias como errores

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler language="c#"

    compilerOptions="warnaserror+" />

  • Suprimir advertencias específicas

    Si se establece su valor, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="nowarn:<warning list>" />

Optimizaciones (proyectos de cliente de Visual Basic)

  • Quitar comprobaciones de desbordamiento con enteros

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="vb"

    compilerOptions="removeintchecks+" />

  • Optimizaciones habilitadas

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="vb"

    compilerOptions="optimize+" />

  • Habilitar generación incremental

    La opción no se convierte.

  • Dirección base del archivo DLL

    La opción no se convierte.

Opciones de configuración: C#

En la tabla siguiente se muestran las opciones de Configuración que aparecen en los proyectos de C# y se describe cómo las trata el proceso de conversión de Visual Studio.

Opción

Lógica de conversión

Generar

  • Constantes de compilación condicional

    La configuración se mueve al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="d:<symbols>" />

  • Optimizar código

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="o" />

  • Comprobar el desbordamiento y subdesbordamiento aritmético

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="checked+" />

  • Permitir bloques de código no seguros

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="unsafe+" />

  • Nivel de advertencia

    Si su valor no es 4, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="w:<level>" />

  • Tratar advertencias como errores

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler language="c#"

    compilerOptions="warnaserror+" />

  • Suprimir advertencias específicas

    Si se establece su valor, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="nowarn:<warning list>" />

  • Ruta de acceso de los resultados

    La opción no se convierte.

  • Documentación XML

    Si se establece su valor, esta opción se traslada al archivo Web.config:

    <compiler language="c#"

    compilerOptions="doc:<filepath>" />

  • Generar información de depuración

    La configuración se mueve al archivo Web.config:

    <compilation debug="true|false" />

  • Registrar para interoperabilidad COM

    La opción no se convierte.

Avanzado

  • Generación incremental

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="incr+" />

  • Dirección base

    La opción no se convierte.

  • Alineación de archivo

    Si su valor no es 4096, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="filealign:<n>" />

  • No usar Mscorlib

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="c#"

    compilerOptions="nostdlib+" />

Opciones de configuración: J#

En la tabla siguiente se muestran las opciones del proyecto Configuración que aparecen en los proyectos de Microsoft J# .NET y se describe cómo las trata el proceso de conversión de Visual Studio.

Opción

Lógica de conversión

Generar

  • Constantes de compilación condicional

    La configuración se mueve al archivo Web.config:

    <compiler

    language="j#"

    compilerOptions="d:<symbols>" />

  • Optimizar código

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler

    language="j#"

    compilerOptions="o" />

  • Nivel de advertencia

    Si su valor no es 4, esta opción se traslada al archivo Web.config:

    <compiler

    language="j#"

    compilerOptions="w:<level>" />

  • Tratar advertencias como errores

    Si su valor es true, esta opción se traslada al archivo Web.config:

    <compiler language="j#"

    compilerOptions="warnaserror+" />

  • Suprimir advertencias específicas

    Si se establece su valor, esta opción se traslada al archivo Web.config:

    <compiler

    language="j#"

    compilerOptions="nowarn:<warning list>" />

  • Ruta de acceso de los resultados

    La opción no se convierte.

  • Generar información de depuración

    La configuración se mueve al archivo Web.config:

    <compilation debug="true|false" />

  • Registrar para interoperabilidad COM

    La opción no se convierte.

Avanzado

  • Dirección base

    La opción no se convierte.

  • Opciones adicionales

    Si se establece su valor, esta opción se traslada al archivo Web.config:

    <compiler

    language="j#"

    compilerOptions="<list of options>" />

Vea también

Conceptos

Conversión de proyectos web de Visual Studio .NET

Conversión de soluciones Web y archivos de proyectos