Página Compilación, Diseñador de proyectos (Visual Basic)Compile Page, Project Designer (Visual Basic)

Use la página Compilación del Diseñador de proyectos para especificar las instrucciones de compilación.Use the Compile page of the Project Designer to specify compilation instructions. En esta página también puede especificar opciones avanzadas del compilador o eventos anteriores o posteriores a la compilación.You can also specify advanced compiler options and pre-build or post-build events on this page.

Para acceder a la página Compilación, seleccione un nodo de proyecto (no el nodo Solución) en el Explorador de soluciones.To access the Compile page, choose a project node (not the Solution node) in Solution Explorer. Después, pulse Proyecto, Propiedades en la barra de menús.Then choose Project, Properties on the menu bar. Cuando se muestre el Diseñador de proyectos, haga clic en la pestaña Compilar.When the Project Designer appears, click the Compile tab.

Nota

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos.The Visual Studio edition that you have and the settings that you use determine these elements. Para obtener más información, vea Personalizar el IDE.For more information, see Personalizing the IDE.

Configuración y plataformaConfiguration and Platform

Los valores siguientes le permiten seleccionar la configuración y la plataforma que se mostrarán o modificarán.The following settings enable you to select the configuration and platform to display or modify.

Nota

Con las configuraciones de compilación simplificadas, el sistema del proyecto determina si se debe compilar una versión de lanzamiento o depuración.With simplified build configurations, the project system determines whether to build a debug or release version. Por tanto, no se muestran las listas Configuración y Plataforma.Therefore, the Configuration and Platform lists are not displayed.

ConfiguraciónConfiguration

Especifica qué opciones de configuración se mostrarán o modificarán.Specifies which configuration settings to display or modify. Los valores son Depurar (el valor predeterminado), Versión o Todas las configuraciones.The settings are Debug (default), Release, or All Configurations. Para más información, vea Descripción de las configuraciones de compilación y Cómo: Crear y editar configuraciones.For more information, see Understanding Build Configurations and How to: Create and Edit Configurations.

PlataformaPlatform

Especifica qué configuración de plataforma se mostrará o modificará.Specifies which platform settings to display or modify. Puede especificar Cualquier CPU (el valor predeterminado), x64 o x86.You can specify Any CPU (default), x64, or x86.

Opciones de configuración del compiladorCompiler Configuration Options

Las opciones siguientes permiten establecer las opciones de configuración del compilador.The following settings enable you to set the compiler configuration options.

Ruta de acceso de salida de la compilaciónBuild output path

Especifica la ubicación de los archivos de salida para la configuración de este proyecto.Specifies the location of the output files for this project's configuration. Escriba la ruta de acceso de salida de la compilación en este cuadro, o bien haga clic en el botón Examinar para seleccionar una ruta de acceso.Type the path of the build output in this box, or click the Browse button to select a path. Tenga en cuenta que la ruta de acceso es relativa; si especifica una ruta de acceso absoluta, se guardará como relativa.Note that the path is relative; if you enter an absolute path, it will be saved as relative. La ruta de acceso predeterminada es bin\Debug\ o bin\Release\.The default path is bin\Debug\ or bin\Release\.

Con las configuraciones de compilación simplificadas, el sistema del proyecto determina si se debe compilar una versión de lanzamiento o depuración.With simplified build configurations, the project system determines whether to build a debug or release version. El comando Compilar del menú Depuración (F5) colocará la compilación en la ubicación de depuración independientemente de la Ruta de acceso de salida que especifique.The Build command from the Debug menu (F5) will put the build in the debug location regardless of the Output path you specify. En cambio, el comando Compilar del menú Compilar la coloca en la ubicación que especifique.However, the Build command from the Build menu puts it in the location you specify.

Option ExplicitOption explicit
Especifica si se permite la declaración implícita de variables.Specifies whether to allow implicit declaration of variables. Seleccione On para requerir la declaración explícita de variables.Select On to require explicit declaration of variables. Esto hace que el compilador notifique errores si las variables no se declaran antes de usarlas.This causes the compiler to report errors if variables are not declared before they are used. Seleccione Off para permitir la declaración implícita de variables.Select Off to allow implicit declaration of variables.

Esta opción corresponde a la opción del compilador /optionexplicit.This setting corresponds to the /optionexplicit compiler option.

Si un archivo de código fuente contiene una instrucción Option Explicit, el valor On u Off de la instrucción invalida el valor de Option Explicit en la página Compilar.If a source code file contains an Option Explicit Statement, the On or Off value in the statement overrides the Option Explicit setting on the Compile page.

Cuando se crea un proyecto, el valor Option Explicit de la página Compilar se establece en el valor de la opción Option Explicit del cuadro de diálogo Opciones.When you create a new project, the Option Explicit setting on the Compile page is set to the value of the Option Explicit setting in the Options dialog box. Para ver o cambiar el valor en este cuadro de diálogo, haga clic en Opciones en el menú Herramientas.To view or change the setting in this dialog box, on the Tools menu, click Options. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, después, haga clic en Valores predeterminados de VB.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. El valor predeterminado inicial de Option Explicit en Valores predeterminados de VB es On.The initial default setting of Option Explicit in VB Defaults is On.

Establecer Option Explicit en Off no suele ser una buena práctica.Setting Option Explicit to Off is generally not a good practice. Podría escribir mal un nombre de variable en una o varias ubicaciones, lo que provocaría resultados inesperados cuando se ejecuta el programa.You could misspell a variable name in one or more locations, which would cause unexpected results when the program is run.

Option StrictOption strict
Especifica si se debe aplicar la semántica estricta de tipos.Specifies whether to enforce strict type semantics. Cuando Option Strict es On, las condiciones siguientes producen un error en tiempo de compilación:When Option Strict is On, the following conditions cause a compile-time error:

  • Conversiones de restricción implícitasImplicit narrowing conversions

  • Enlace en tiempo de ejecuciónLate binding

  • Tipos implícitos que dan como resultado un tipo ObjectImplicit typing that results in an Object type

Los errores de conversión de restricción implícita se producen cuando existe una conversión de tipos de datos implícita que es una conversión de restricción.Implicit narrowing conversion errors occur when there is an implicit data type conversion that is a narrowing conversion. Para más información, vea Option Strict (instrucción), Conversiones implícitas y explícitas y Conversiones de ampliación y de restricción.For more information, see 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 un método de una variable que se declara como variable de tipo Object.An object is late bound when it is assigned to a property or method of a variable that is declared to be of type Object. Para más información, vea Option Strict (instrucción) y Enlace en tiempo de compilación y en tiempo de ejecución.For more information, see Option Strict Statement and 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 infiere un tipo de Object.Implicit object type errors occur when an appropriate type cannot be inferred for a declared variable, so a type of Object is inferred. Esto se produce principalmente cuando se usa una instrucción Dim para declarar una variable sin usar una cláusula As y Option Infer está desactivado.This primarily occurs when you use a Dim statement to declare a variable without using an As clause, and Option Infer is off. Para más información, vea Option Strict (instrucción), Option Infer (instrucción) y la Especificación del lenguaje Visual Basic.For more information, see Option Strict Statement, Option Infer Statement, and the Visual Basic Language Specification.

La opción Option Strict corresponde a la opción del compilador /optionstrict.The Option Strict setting corresponds to the /optionstrict compiler option.

Si un archivo de código fuente contiene una instrucción Option Strict, el valor On u Off de la instrucción invalida el valor de Option Strict en la página Compilar.If a source code file contains an Option Strict Statement, the On or Off value in the statement overrides the Option Strict setting on the Compile page.

Cuando se crea un proyecto, el valor Option Strict de la página Compilar se establece en el valor de la opción Option Strict del cuadro de diálogo Opciones.When you create a project, the Option Strict setting on the Compile page is set to the value of the Option Strict setting in the Options dialog box. Para ver o cambiar el valor en este cuadro de diálogo, haga clic en Opciones en el menú Herramientas.To view or change the setting in this dialog box, on the Tools menu, click Options. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, después, haga clic en Valores predeterminados de VB.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. El valor predeterminado inicial de Option Strict en Valores predeterminados de VB es Off.The initial default setting of Option Strict in VB Defaults is Off.

Advertencias individuales de Option Strict.Option Strict Individual Warnings. En la sección Configuraciones de advertencias de la página Compilar se incluyen valores que se corresponden con las tres condiciones que producen un error en tiempo de compilación cuando Option Strict está activado.The Warning configurations section of the Compile page has settings that correspond to the three conditions that cause a compile-time error when Option Strict is on. Estas opciones son las siguientes:Following are these settings:

  • Conversión implícitaImplicit conversion

  • Enlace en tiempo de ejecución; la llamada podría generar un error en tiempo de ejecuciónLate binding; call could fail at run time

  • Tipo implícito; se supone el objetoImplicit type; object assumed

Al establecer Option Strict en On, estos tres valores de configuración de advertencias se establecen en Error.When you set Option Strict to On, all three of these warning configuration settings are set to Error. Al establecer Option Strict en Off, las tres opciones se establecen en None.When you set Option Strict to Off, all three settings are set to None.

Puede cambiar individualmente cada valor de configuración de advertencia por None, Warning o Error.You can individually change each warning configuration setting to None, Warning, or Error. Si se establecen las tres opciones de configuración de advertencia en Error, On aparece en el cuadro Option strict.If all three warning configuration settings are set to Error, On appears in the Option strict box. Si se establecen las tres en None, Off aparece en este cuadro.If all three are set to None, Off appears in this box. Para cualquier otra combinación de estas opciones, aparece (personalizado).For any other combination of these settings, (custom) appears.

Option CompareOption compare
Especifica el tipo de comparación de cadena que se va a usar.Specifies the type of string comparison to use. Seleccione Binario para indicar al compilador que use comparaciones de cadenas binarias que distingan mayúsculas de minúsculas.Select Binary to instruct the compiler to use binary, case-sensitive string comparisons. Seleccione Texto para usar comparaciones de cadenas de texto que no distingan mayúsculas de minúsculas específicas de la configuración regional.Select Text to use locale-specific, case-insensitive text string comparisons.

Esta opción corresponde a la opción del compilador /optioncompare.This setting corresponds to the /optioncompare compiler option.

Si un archivo de código fuente contiene una instrucción Option Compare, el valor Binary u Text de la instrucción invalida el valor de Option Compare en la página Compilar.If a source code file contains an Option Compare Statement, the Binary or Text value in the statement overrides the Option Compare setting on the Compile page.

Cuando se crea un proyecto, el valor Option Compare de la página Compilar se establece en el valor de la opción Option Compare del cuadro de diálogo Opciones.When you create a project, the Option Compare setting on the Compile page is set to the value of the Option Compare setting in the Options dialog box. Para ver o cambiar el valor en este cuadro de diálogo, haga clic en Opciones en el menú Herramientas.To view or change the setting in this dialog box, on the Tools menu, click Options. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, después, haga clic en Valores predeterminados de VB.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. El valor predeterminado inicial de Option Compare en Valores predeterminados de VB es Binario.The initial default setting of Option Compare in VB Defaults is Binary.

Option InferOption infer
Especifica si se permite la inferencia de tipo de variable local en las declaraciones de variables.Specifies whether to allow local type inference in variable declarations. Seleccione On para permitir el uso de la inferencia de tipo de variable local.Select On to allow the use of local type inference. Seleccione Off para bloquear la inferencia de tipo de variable local.Select Off to block local type inference.

Esta opción corresponde a la opción del compilador /optioninfer.This setting corresponds to the /optioninfer compiler option.

Si un archivo de código fuente contiene una instrucción Option Infer, el valor On u Off de la instrucción invalida el valor de Option Infer en la página Compilar.If a source code file contains an Option Infer Statement, the On or Off value in the statement overrides the Option Infer setting on the Compile page.

Cuando se crea un proyecto, el valor Option Infer de la página Compilar se establece en el valor de la opción Option Infer del cuadro de diálogo Opciones.When you create a project, the Option Infer setting on the Compile page is set to the value of the Option Infer setting in the Options dialog box. Para ver o cambiar el valor en este cuadro de diálogo, haga clic en Opciones en el menú Herramientas.To view or change the setting in this dialog box, on the Tools menu, click Options. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, después, haga clic en Valores predeterminados de VB.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. El valor predeterminado inicial de Option Infer en Valores predeterminados de VB es On.The initial default setting of Option Infer in VB Defaults is On.

CPU de destinoTarget CPU
Especifica el procesador que será el destino del archivo de salida.Specifies the processor to be targeted by the output file. Especifique x86 para cualquier procesador compatible con Intel de 32 bits, x64 para cualquier procesador compatible con Intel de 64 bits, ARM para procesadores ARM o Cualquier CPU para especificar que se aceptan todos los procesadores.Specify x86 for any 32-bit Intel-compatible processor, x64 for any 64-bit Intel-compatible processor, ARM for any ARM processor, or Any CPU to specify that any processor is acceptable. Cualquier CPU es el valor predeterminado para los proyectos nuevos, ya que permite que la aplicación se ejecute en el mayor número de tipos de hardware.Any CPU is the default value for new projects because it allows the application to run on the largest number of hardware types.

Para más información, vea /platform (Visual Basic).For more information, see /platform (Visual Basic).

Preferencia de 32 bitsPrefer 32-bit
Si está seleccionada la casilla Preferencia de 32 bits, la aplicación se ejecuta como una aplicación de 32 bits en versiones de 32 bits y 64 bits de Windows.If the Prefer32-bit check box is selected, the application runs as a 32-bit application on both 32-bit and 64-bit versions of Windows. En caso 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.Otherwise, the application runs as a 32-bit application on 32-bit versions of Windows and as a 64-bit application on 64-bit versions of Windows.

Ejecutar una aplicación como de 64 bits duplica el tamaño de puntero, y puede provocar problemas de compatibilidad con las bibliotecas que son exclusivamente de 32 bits.Running as a 64-bit application doubles the pointer size, and it can cause compatibility problems with libraries that are exclusively 32-bit. 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.It makes sense to run an application as 64-bit only if it runs significantly faster or needs more than 4 GB of memory.

Esta casilla solo está disponible si se cumplen todas las condiciones siguientes:This check box is available only if all of the following conditions are true:

  • En la página Compilar, la lista CPU de destino se establece en Cualquier CPU.On the Compile Page, the Target CPU list is set to Any CPU.

  • En la Página de aplicación, la lista Tipo de aplicación especifica que el proyecto es una aplicación.On the Application Page, the Application type list specifies that the project is an application.

  • En la Página de aplicación, la lista Marco de trabajo de destino especifica .NET Framework 4.5.On the Application Page, the Target framework list specifies the .NET Framework 4.5.

Configuraciones de advertenciasWarning configurations
En esta tabla se enumeran las condiciones de compilación y el correspondiente nivel de notificación de Ninguno, Advertencia o Error para cada una.This table lists build conditions and the corresponding notification level of None, Warning, or Error for each.

De forma predeterminada, todas las advertencias del compilador se agregan a la lista de tareas durante la compilación.By default, all compiler warnings are added to the Task List during compilation. Seleccione Deshabilitar todas las advertencias para indicar al compilador que no emita advertencias ni errores.Select Disable all warnings to instruct the compiler not to issue warnings or errors. Seleccione Tratar todas las advertencias como errores si quiere que el compilador trate las advertencias como errores que se deben corregir.Select Treat all warnings as errors if you want the compiler to treat warnings as errors that must be fixed.

Deshabilitar todas las advertenciasDisable all warnings
Especifica si se debe permitir que el compilador emita notificaciones como se especifica en la tabla Condición y notificación descrita anteriormente en este documento.Specifies whether to allow the compiler to issue notifications as specified in the Condition and Notification table described earlier in this document. Esta casilla se encuentra desactivada de forma predeterminada.By default, this check box is cleared. Active esta casilla para indicar al compilador que no emita advertencias ni errores.Select this check box to instruct the compiler not to issue warnings or errors.

Esta opción corresponde a la opción del compilador /nowarn.This setting corresponds to the /nowarn compiler option.

Tratar todas las advertencias como erroresTreat all warnings as errors
Especifica cómo tratar las advertencias.Specifies how to treat warnings. De forma predeterminada, esta casilla está desactivada, por lo que todas las notificaciones de advertencias permanecen establecidas en Advertencia.By default, this check box is cleared, so that all warning notifications remain set to Warning. Active esta casilla para cambiar todas las notificaciones de advertencia a Error.Select this check box to change all warning notifications to Error.

Esta opción solo está disponible si Deshabilitar todas las advertencias está desactivada.This option is available only if Disable all warnings is cleared.

Generar archivo de documentación XMLGenerate XML documentation file
Especifica si se debe generar o no información de documentación.Specifies whether to generate documentation information. De forma predeterminada, esta casilla está activada para indicar al compilador que genere información de documentación y la incluya en un archivo XML.By default, this check box is selected, instructing the compiler to generate documentation information and include it in an XML file. Desactive esta casilla para indicar al compilador que no cree la documentación.Clear this check box to instruct the compiler not to create documentation.

Esta opción corresponde a la opción del compilador /doc.This setting corresponds to the /doc compiler option.

Registrar para interoperabilidad COMRegister for COM interop
Especifica si la aplicación administrada expondrá un objeto COM (un contenedor CCW) que permite a un objeto COM interactuar con la aplicación.Specifies whether your managed application will expose a COM object (a COM-callable wrapper) that enables a COM object to interact with the application.

De forma predeterminada, esta casilla está desactivada, lo que especifica que la aplicación no permitirá la interoperabilidad COM.By default, this check box is cleared, which specifies that the application will not allow COM interop. Active esta casilla para permitir la interoperabilidad COM.Select this check box to allow COM interop.

Esta opción no está disponible para los proyectos de aplicación Windows o de aplicación de consola.This option is not available for Windows Application or Console Application projects.

Eventos de compilaciónBuild Events
Haga clic en este botón para tener acceso al cuadro de diálogo Eventos de compilación.Click this button to access the Build Events dialog box. Use este cuadro de diálogo para especificar las instrucciones de configuración anteriores y posteriores a la compilación para el proyecto.Use this dialog box to specify pre-build and post-build configuration instructions for the project. Este cuadro de diálogo solo se aplica a proyectos de Visual Basic.This dialog box applies to Visual Basic projects only. Para más información, vea Eventos de compilación (Cuadro de diálogo) (Visual Basic).For more information, see Build Events Dialog Box (Visual Basic).

Opciones de compilación avanzadasAdvanced Compile Options
Haga clic en este botón para tener acceso al cuadro de diálogo Configuración de compilador avanzada.Click this button to access the AdvancedCompiler Settings dialog box. Use el cuadro de diálogo Configuración de compilador avanzada para especificar las propiedades de configuración de compilación avanzada del proyecto.Use the AdvancedCompiler Settings dialog box to specify a project's advanced build configuration properties. Este cuadro de diálogo solo se aplica a proyectos de Visual Basic.This dialog box applies to Visual Basic projects only. Para más información, vea Configuración de compilador avanzada (Cuadro de diálogo, Visual Basic).For more information, see Advanced Compiler Settings Dialog Box (Visual Basic).

Vea tambiénSee also