Opciones del compilador de C#

En esta sección se describen las opciones interpretadas por el compilador de C#. Las opciones se agrupan en artículos independientes en función de lo que controlan, por ejemplo, las características del lenguaje, la generación de código y la salida. Use la tabla de contenido para navegar entre ellos.

Establecimiento de opciones

Hay dos maneras diferentes de establecer opciones del compilador en proyectos de .NET:

• En el archivo *.csproj

  Puede agregar propiedades de MSBuild para cualquier opción del compilador en el archivo *.csproj en formato XML. El nombre de la propiedad es el mismo que la opción del compilador. El valor de la propiedad establece el valor de la opción del compilador. Por ejemplo, el siguiente fragmento de código de archivo de proyecto establece la LangVersion propiedad .

  <PropertyGroup>
    <LangVersion>preview</LangVersion>
  </PropertyGroup>
  

  Para obtener más información sobre cómo establecer opciones en archivos de proyecto, consulte el artículo Propiedades de MSBuild para proyectos del SDK de .NET.

• Uso de las páginas de propiedades de Visual Studio

  Visual Studio proporciona páginas de propiedades para editar las propiedades de compilación. Para obtener más información sobre ellos, consulte Administrar propiedades de proyecto y solución: Windows o Administrar propiedades de proyecto y solución : Mac.

Proyectos de .NET Framework

Importante

Esta sección solo se aplica a proyectos de .NET Framework.

Además de los mecanismos descritos anteriormente, puede establecer opciones del compilador mediante dos métodos adicionales para proyectos de .NET Framework:

• Argumentos de línea de comandos para proyectos de .NET Framework: los proyectos de .NET Framework usan csc.exe en lugar de dotnet build compilar proyectos. Puede especificar argumentos de línea de comandos para csc.exe para proyectos de .NET Framework.
• Páginas de ASP.NET compiladas: los proyectos de .NET Framework usan una sección del archivo web.config para compilar páginas. Para el nuevo sistema de compilación y ASP.NET proyectos core, las opciones se toman del archivo de proyecto.

La palabra para algunas opciones del compilador cambió de csc.exe y proyectos de .NET Framework al nuevo sistema de MSBuild. La nueva sintaxis se usa en esta sección. Ambas versiones se muestran en la parte superior de cada página. Para csc.exe, los argumentos se enumeran siguiendo la opción y dos puntos. Por ejemplo, la -doc opción sería:

-doc:DocFile.xml

Puede invocar el compilador de C# escribiendo el nombre de su archivo ejecutable (csc.exe) en un símbolo del sistema.

En el caso de los proyectos de .NET Framework, también puede ejecutar csc.exe desde la línea de comandos. Cada opción del compilador está disponible en dos formas: -option y /option. En los proyectos web de .NET Framework, especifique opciones para compilar código subyacente en el archivo web.config . Para obtener más información, vea <compiler> Element.

Si usa la ventana Del símbolo del sistema para desarrolladores para Visual Studio , se establecen todas las variables de entorno necesarias. Para obtener información sobre cómo acceder a esta herramienta, vea Símbolo del sistema para desarrolladores para Visual Studio.

El archivo ejecutable csc.exe normalmente se encuentra en la carpeta Microsoft.NET\Framework\<Version> en el directorio windows . Su ubicación puede variar en función de la configuración exacta de un equipo determinado. Si hay más de una versión de .NET Framework instalada en el equipo, encontrará varias versiones de este archivo. Para obtener más información sobre estas instalaciones, vea Cómo: determinar qué versiones de .NET Framework están instaladas.