Compilar (Página, Diseñador de proyectos) (C#)

  • Artículo

Use la página Compilar del Diseñador de proyectos para especificar las propiedades de configuración de compilación del proyecto. Esta opción solo es aplicable a proyectos de Visual C#.

Para obtener acceso a la página Compilar, seleccione un nodo de proyecto (no el nodo Solución) en el Explorador de soluciones. Después, en el menú, seleccione Ver, Páginas de propiedades. Cuando se muestre el Diseñador de proyectos, pulse la pestaña Compilar.

Nota

Es posible que el equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en 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, vea Personalizar el IDE.

Configuración y plataforma

Las siguientes opciones le permiten seleccionar la configuración y la plataforma que se mostrarán o modificarán.

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. Por tanto, estas opciones no se muestran. Para obtener más información, vea Cómo: Establecer configuraciones Debug y Release.

Configuración

Especifica qué opciones de configuración se mostrarán o modificarán. Los valores pueden ser (Depurar) activa (es el valor predeterminado), Depuración, Lanzamiento o Todas las configuraciones.

Plataforma

Especifica qué configuración de plataforma se mostrará o modificará. La configuración predeterminada es (Cualquier CPU) activa. Puede cambiar la plataforma activa mediante el Administrador de configuración. Para obtener más información, vea Cómo: Crear y editar configuraciones.

General

Las opciones siguientes le permiten configurar varias opciones del compilador de C#.

Símbolos de compilación condicional

Especifica símbolos con los que realizar la compilación condicional. Separe los símbolos con un punto y coma (";"). Para obtener más información, consulte /define (Opciones del compilador de C#).

Definir constante DEBUG

Define DEBUG como un símbolo en todos los archivos de código fuente de la aplicación. Seleccionar esta opción equivale a usar la opción de línea de comandos /define:DEBUG.

Definir constante TRACE

Define TRACE como un símbolo en todos los archivos de código fuente de la aplicación. Seleccionar esta opción equivale a usar la opción de línea de comandos /define:TRACE.

Destino de la plataforma

Especifica el procesador que será el destino del archivo de salida. Elija x86 para cualquier procesador compatible con Intel de 32 bits; elija x64 para cualquier procesador compatible con Intel de 64 bits; elija ARM para procesadores ARM; o elija Cualquier CPU para especificar que se aceptan todos los procesadores. Cualquier CPU es el valor predeterminado para los proyectos, ya que permite que la aplicación se ejecute en la gran mayoría del hardware.

Para obtener más información, consulte /platform (Opciones del compilador de C#).

Admisión de valores NULL

Especifica el contexto de C# que admite un valor NULL en todo el proyecto. Esta opción de la interfaz de usuario se presentó en Visual Studio 16.5 y solo está habilitada para los proyectos en los que se usa C# 8.0 o una versión posterior.

Para más información, vea Contextos que admiten un valor NULL.

Preferencia de 32 bits

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. Si la casilla está desactivada, la aplicación se ejecutará 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.

Si ejecuta una aplicación como una aplicación de 64 bits, el tamaño del puntero es el doble y se pueden producir problemas de compatibilidad con otras bibliotecas que son exclusivamente de 32 bits. Es útil ejecutar una aplicación de 64 bits solo si necesita más de 4 GB de memoria o si las instrucciones de 64 bits proporcionan una mejora considerable del rendimiento.

Esta casilla solo está disponible si se cumplen todas las condiciones siguientes:

  • En Compilar página, la lista Destino de la plataforma está establecida en Cualquier CPU.

  • En la Página de aplicación, la lista Tipo de salida especifica que el proyecto es una aplicación.

  • En la Página de aplicación, la lista Marco de trabajo de destino especifica .NET Framework 4.5.

Permitir código no seguro

Permite la compilación de código en el que se usa la palabra clave unsafe. Para obtener más información, consulte /unsafe (Opciones del compilador de C#).

Optimizar código

Habilite o deshabilite las optimizaciones realizadas por el compilador para que el archivo de salida sea menor, más rápido y más eficaz. Para obtener más información, consulte /optimize (Opciones del compilador de C#).

Errores y advertencias

Las siguientes opciones se usan para configurar las opciones de advertencia y error para el proceso de compilación.

Nivel de advertencia

Especifica el nivel que se debe mostrar para las advertencias del compilador. Para obtener más información, consulte /warn (Opciones del compilador de C#).

Suprimir advertencias

Bloquea la capacidad del compilador de generar una o varias advertencias. Separe varios números de advertencia con una coma o un punto y coma. Para obtener más información, consulte /nowarn (Opciones del compilador de C#).

Tratar advertencias como errores

Las siguientes opciones se usan para especificar qué advertencias se tratan como errores. Seleccione una de las siguientes opciones para indicar en qué condiciones se devolverá un error cuando la compilación encuentra una advertencia. Para obtener más información, consulte /warnaserror (Opciones del compilador de C#).

Ninguna: no se trata ninguna advertencia como error.

Todas: todas las advertencias se tratan como errores.

Advertencias específicas: las advertencias especificadas se tratan como errores. Separe varios números de advertencia con una coma o un punto y coma.

Sugerencia

Si no quiere que las advertencias de análisis de código se traten como errores, vea Preguntas más frecuentes sobre análisis de código.

Resultados

Las siguientes opciones se usan para configurar las opciones de salida para el proceso de compilación.

Ruta de acceso de salida

Especifica la ubicación de los archivos de salida para la configuración de este proyecto. Escriba la ruta de acceso de salida de la compilación en este cuadro, o elija el botón Examinar para especificar una ruta de acceso. La ruta de acceso es relativa; si especifica una ruta de acceso absoluta, se guardará como relativa. La ruta de acceso predeterminada es bin\Debug\ o 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. 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. En cambio, el comando Compilar del menú Compilar la coloca en la ubicación que especifique. Para obtener más información, vea Descripción de las configuraciones de compilación.

Archivo de documentación XML

Especifica el nombre de un archivo en el que se procesarán comentarios sobre documentación. Para obtener más información, consulte /doc (Opciones del compilador de C#).

Registrar para interoperabilidad COM

Indica que la aplicación administrada expondrá un objeto COM (un contenedor CCW) que permite a un objeto COM interactuar con la aplicación administrada. La propiedad Tipo de salida de la página Aplicación del Diseñador de proyectos de esta aplicación debe establecerse en Biblioteca de clases para que la propiedad Registrar para interoperabilidad COM esté disponible. Para ver una clase de ejemplo que puede incluir en la aplicación de Visual C# y exponer como un objeto COM, consulte Clase COM de ejemplo.

Generar ensamblados de serialización

Especifica si el compilador usará la herramienta Generador de serializador XML (Sgen.exe) para crear ensamblados de serialización XML. Los ensamblados de serialización pueden mejorar el rendimiento de inicio de XmlSerializer si ha usado esa clase para serializar los tipos en el código. De manera predeterminada, esta opción se establece en Automático, que especifica que los ensamblados de serialización se generan solo si ha usado XmlSerializer para codificar los tipos del código en XML. Desactivado especifica que los ensamblados de serialización no se generan nunca, independientemente de si el código usa XmlSerializer. Activado especifica que siempre se generan ensamblados de serialización. Los ensamblados de serialización se denominan TypeName.XmlSerializers.dll. Para obtener más información, consulte Herramienta Generador de serializador XML (Sgen.exe).

Avanzadas

Haga clic para mostrar el cuadro de diálogo Configuración de compilación avanzada (Cuadro de diálogo, C#).

Vea también