Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota:
Esta página hace referencia a la experiencia del Diseñador de proyectos en Visual Studio 2019 y para proyectos de .NET Framework con Visual Studio 2022.
Use la página Compilar del Diseñador de proyectos para especificar instrucciones de compilación. También puede especificar opciones avanzadas del compilador y eventos previos o posteriores a la compilación en esta página.
Para acceder a la página Compilar , elija un nodo de proyecto (no el nodo solución ) en el Explorador de soluciones. A continuación, elija Proyecto, Propiedades en la barra de menús . Cuando aparezca el Diseñador de proyectos, haga clic en la pestaña Compilar .
Nota:
El equipo puede mostrar nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio de este artículo. Es posible que esté usando una edición diferente de Visual Studio o una configuración de entorno diferente. Para obtener más información, consulte Personalizar el IDE.
Configuración y plataforma
La siguiente configuración le permite seleccionar la configuración y la plataforma para mostrar o modificar.
Nota:
Con configuraciones de compilación simplificadas, el sistema de proyecto determina si se va a compilar una versión de depuración o versión. Por lo tanto, no se muestran las listas configuración y plataforma .
Configuración
Especifica qué opciones de configuración se van a mostrar o modificar. Los valores son Depuración (valor predeterminado), Versión o Todas las configuraciones. Para obtener más información, vea Descripción de las configuraciones de compilación y Cómo: Crear y editar configuraciones.
Plataforma
Especifica qué configuración de plataforma se va a mostrar o modificar. Puede especificar Cualquier CPU (valor predeterminado), x64 o x86.
Opciones de configuración del compilador
La siguiente configuración le permite establecer las opciones de configuración del compilador.
Ruta de acceso de salida de compilación
Especifica la ubicación de los archivos de salida para la configuración de este proyecto. Escriba la ruta de acceso de la salida de compilación en este cuadro o haga clic en el botón Examinar para seleccionar una ruta de acceso. Tenga en cuenta que la ruta de acceso es relativa; si escribe una ruta de acceso absoluta, se guardará como relativa. La ruta de acceso predeterminada es bin\Debug\ o bin\Release\.
Con configuraciones de compilación simplificadas, el sistema de proyecto determina si se va a compilar una versión de depuración o versión. El comando
Opción explícita
Especifica si se va a permitir la declaración implícita de variables. Seleccione Activado para requerir la declaración explícita de variables. Esto hace que el compilador notifique errores si no se declaran variables antes de que se usen. Seleccione Desactivar para permitir la declaración implícita de variables.
Esta configuración corresponde a la opción del compilador /optionexplicit .
Si un archivo de código fuente contiene una instrucción Option Explicit, el On valor o Off de la instrucción invalida la configuración Option Explicit en la página Compilar.
Al crear un nuevo proyecto, la opción Explícita de la página Compilar se establece en el valor de la opción Explicit del cuadro de diálogo Opciones . Para ver o cambiar la configuración de este cuadro de diálogo, en el menú Herramientas , haga clic en Opciones. En el cuadro de diálogo Opciones , expanda Proyectos y soluciones y, a continuación, haga clic en Valores predeterminados de VB. El valor predeterminado inicial de Option Explicit en VB Defaults es Activado.
Establecer option Explicit en Off general no es un procedimiento recomendado. Puede mal escribir un nombre de variable en una o varias ubicaciones, lo que provocaría resultados inesperados cuando se ejecuta el programa.
Opción estricta
Especifica si se debe aplicar la semántica de tipos estrictas. Cuando Option Strict es Activado, las condiciones siguientes provocan un error en tiempo de compilación:
Conversiones de restricción implícitas
Enlace en tiempo de demora
Escritura implícita que da como resultado un
Objecttipo
Los errores de conversión de restricción implícita se producen cuando hay una conversión de tipo de datos implícita que es una conversión de restricción. Para obtener más información, vea Option Strict Statement, Implicit and Explicit Conversions, and Widening and Narrowing Conversions.
Un objeto se enlaza en tiempo de ejecución cuando se asigna a una propiedad o método de una variable que se declara como de tipo Object. Para obtener más información, vea Option Strict Statement y Early and Late Binding.
Los errores de tipo de objeto implícito se producen cuando no se puede inferir un tipo adecuado para una variable declarada, por lo que se deduce un tipo de Object . Esto se produce principalmente cuando se usa una Dim instrucción para declarar una variable sin usar una As cláusula y Option Infer está desactivada. Para obtener más información, vea Option Strict Statement, Option Infer Statement y Visual Basic Language Specification.
La opción Option Strict corresponde a la opción del compilador /optionstrict .
Si un archivo de código fuente contiene una instrucción Option Strict, el On valor o Off de la instrucción invalida la opción Option Strict en la página Compilar.
Al crear un proyecto, la opción Option Strict de la página Compilar se establece en el valor de la opción Option Strict en el cuadro de diálogo Opciones . Para ver o cambiar la configuración de este cuadro de diálogo, en el menú Herramientas , haga clic en Opciones. En el cuadro de diálogo Opciones , expanda Proyectos y soluciones y, a continuación, haga clic en Valores predeterminados de VB. La configuración predeterminada inicial de Option Strict en VB Defaults es Desactivado.
Advertencias individuales estrictas de opción
La sección Configuraciones de advertencia de la página Compilar tiene valores que corresponden a las tres condiciones que provocan un error en tiempo de compilación cuando Option Strict está activado. A continuación se muestran estas opciones:
Conversión implícita
Enlace en tiempo de demora; la llamada podría producir un error en tiempo de ejecución
Tipo implícito; objeto asumido
Al establecer Option Strict en Activado, las tres opciones de configuración de advertencia se establecen en Error. Al establecer Option Strict en Desactivado, los tres valores se establecen en Ninguno.
Puede cambiar individualmente cada opción de configuración de advertencia a Ninguno, Advertencia o Error. Si los tres valores de configuración de advertencia se establecen en Error, On aparece en el Option strict cuadro . Si los tres se establecen en Ninguno, Off aparece en este cuadro. Para cualquier otra combinación de estos valores, aparece (personalizado).
Comparación de opciones
Especifica el tipo de comparación de cadenas que se va a usar. Seleccione Binario para indicar al compilador que use comparaciones de cadenas binarias y que distinguen mayúsculas de minúsculas. Seleccione Texto para usar comparaciones de cadenas de texto que no distinguen mayúsculas de minúsculas y específicas de la configuración regional.
Esta configuración corresponde a la opción del compilador /optioncompare .
Si un archivo de código fuente contiene una instrucción Option Compare, el Binary valor o Text de la instrucción invalida la opción Comparación de opciones en la página Compilar.
Al crear un proyecto, la opción Comparación de opciones de la página Compilar se establece en el valor de la opción Comparación de opciones en el cuadro de diálogo Opciones . Para ver o cambiar la configuración de este cuadro de diálogo, en el menú Herramientas , haga clic en Opciones. En el cuadro de diálogo Opciones , expanda Proyectos y soluciones y, a continuación, haga clic en Valores predeterminados de VB. La configuración predeterminada inicial de Option Compare en valores predeterminados de VB es Binary.
Inferencia de opción
Especifica si se va a permitir la inferencia de tipos locales en declaraciones de variables. Seleccione Activado para permitir el uso de la inferencia de tipos locales. Seleccione Desactivar para bloquear la inferencia de tipos locales.
Esta configuración corresponde a la opción del compilador /optioninfer .
Si un archivo de código fuente contiene una instrucción Option Infer, el On valor o Off de la instrucción invalida la opción Option Infer en la página Compilar.
Al crear un proyecto, la opción Inferir de la página Compilar se establece en el valor de la opción Inferir en el cuadro de diálogo Opciones . Para ver o cambiar la configuración de este cuadro de diálogo, en el menú Herramientas , haga clic en Opciones. En el cuadro de diálogo Opciones , expanda Proyectos y soluciones y, a continuación, haga clic en Valores predeterminados de VB. El valor predeterminado inicial de Option Infer in VB Defaults es Activado.
CPU de destino
Especifica el procesador al que va dirigido el archivo de salida. Especifique x86 para cualquier procesador compatible con Intel de 32 bits, x64 para cualquier procesador compatible con Intel de 64 bits, ARM para cualquier procesador ARM o Cualquier CPU para especificar que cualquier procesador sea aceptable. Cualquier CPU es el valor predeterminado de los nuevos proyectos porque permite que la aplicación se ejecute en el mayor número de tipos de hardware.
Para obtener más información, vea /platform (Visual Basic).
Preferir 32 bits
Si la casilla Prefer32 bits está activada, la aplicación se ejecuta como una aplicación de 32 bits en versiones de 32 y 64 bits de Windows. De lo contrario, la aplicación se ejecuta como una aplicación de 32 bits en versiones de 32 bits de Windows y como una aplicación de 64 bits en versiones de 64 bits de Windows.
La ejecución como una aplicación de 64 bits duplica el tamaño del puntero y puede provocar problemas de compatibilidad con las bibliotecas que son exclusivamente de 32 bits. Tiene sentido ejecutar una aplicación como de 64 bits solo si se ejecuta significativamente más rápido o necesita más de 4 GB de memoria.
Esta casilla solo está disponible si se cumplen todas las condiciones siguientes:
En la página Compilar, la lista CPU de destino se establece en Cualquier CPU.
En la página Aplicación, la lista Tipo de aplicación especifica que el proyecto es una aplicación.
En la página Aplicación, la lista Plataforma de destino especifica .NET Framework 4.5.
Configuraciones de advertencia
En esta tabla se enumeran las condiciones de compilación y el nivel de notificación correspondiente de Ninguno, Advertencia o Error para cada uno.
De forma predeterminada, todas las advertencias del compilador se agregan a la lista de tareas durante la compilación. Seleccione Deshabilitar todas las advertencias para indicar al compilador que no emita advertencias o errores. Seleccione Tratar todas las advertencias como errores si desea que el compilador trate las advertencias como errores que deben corregirse.
Deshabilitar todas las advertencias
Especifica si se permite que el compilador emita notificaciones como se especifica en la tabla Condición y notificación descrita anteriormente en este documento. De forma predeterminada, esta casilla está desactivada. Active esta casilla para indicar al compilador que no emita advertencias o errores.
Esta configuración corresponde a la opción del compilador /nowarn .
Tratar todas las advertencias como errores
Especifica cómo tratar las advertencias. De forma predeterminada, esta casilla está desactivada, de modo que todas las notificaciones de advertencia permanezcan establecidas en Advertencia. Active esta casilla para cambiar todas las notificaciones de advertencia a Error.
Esta opción solo está disponible si deshabilita todas las advertencias está desactivada.
Generación de un archivo de documentación XML
Especifica si se va a generar información de documentación. De forma predeterminada, esta casilla está activada, lo que indica al compilador que genere información de documentación e inclúyelo en un archivo XML. Desactive esta casilla para indicar al compilador que no cree documentación.
Esta configuración corresponde a la opción del compilador /doc .
Registro para la interoperabilidad COM
Especifica si la aplicación administrada expondrá un objeto COM (un contenedor al que se puede llamar COM) que permita que un objeto COM interactúe con la aplicación.
De forma predeterminada, esta casilla está desactivada, que especifica que la aplicación no permitirá la interoperabilidad COM. Active esta casilla para permitir la interoperabilidad COM.
Esta opción no está disponible para proyectos de aplicación o aplicación de consola de Windows.
Eventos de compilación
Haga clic en este botón para acceder al cuadro de diálogo Eventos de compilación . Use este cuadro de diálogo para especificar instrucciones de configuración anteriores a la compilación y posteriores al proyecto. Este cuadro de diálogo solo se aplica a los proyectos de Visual Basic. Para obtener más información, vea Build Events Dialog Box (Visual Basic).
Opciones avanzadas de compilación
Haga clic en este botón para acceder al cuadro de diálogo Configuración avanzada del compilador . Use el cuadro de diálogo Configuración avanzada del compilador para especificar las propiedades avanzadas de configuración de compilación de un proyecto. Este cuadro de diálogo solo se aplica a los proyectos de Visual Basic. Para obtener más información, vea Configuración avanzada del compilador (Cuadro de diálogo) (Visual Basic).