Csc (Tarea)
Actualización: noviembre 2007
Contiene CSC.exe y genera archivos ejecutables (.exe), bibliotecas de vínculos dinámicos (.dll) o módulos de código (.netmodule). Para obtener más información acerca de CSC.exe, vea Opciones del compilador de C#.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea Csc.
Parámetro |
Descripción |
|---|---|
AdditionalLibPaths |
Parámetro String[] opcional. Especifica directorios adicionales donde buscar referencias. Para obtener más información, vea /lib (Especificar ubicaciones de referencias de ensamblados) (Opciones del compilador de C#). |
AddModules |
Parámetro String opcional. Especifica uno o varios módulos como parte del ensamblado. Para obtener más información, vea /addmodule (Importar metadatos) (Opciones del compilador de C#). |
AllowUnsafeBlocks |
Parámetro Boolean opcional. Si true, compila código que utiliza la palabra clave unsafe. Para obtener más información, vea /unsafe (Habilitar modo Unsafe) (Opciones del compilador de C#). |
BaseAddress |
Parámetro String opcional. Especifica la dirección base preferente en la que se debe cargar un archivo DLL. La dirección base predeterminada de un archivo DLL la establece Common Language Runtime de .NET Framework. Para obtener más información, vea /baseaddress (Especificar la dirección base de un archivo DLL) (Opciones del compilador de C#). |
CheckForOverflowUnderflow |
Parámetro Boolean opcional. Especifica si, en caso de que la aritmética de enteros desborde los límites del tipo de datos, se producirá una excepción en tiempo de ejecución. Para obtener más información, vea /checked (Comprobar aritmética de enteros) (Opciones del compilador de C#). |
CodePage |
Parámetro Int32 opcional. Especifica la página de códigos que debe utilizarse para todos los archivos de código fuente en la compilación. Para obtener más información, vea /codepage (Especificar una página de códigos para los archivos de código fuente) (Opciones del compilador de C#). |
DebugType |
Parámetro String opcional. Especifica el tipo de depuración. DebugType puede ser full o pdbonly. El valor predeterminado es full, lo que permite adjuntar un depurador a un programa en ejecución. Especificar la opción pdbonly permite depurar el código fuente cuando el programa se inicia en el depurador, pero sólo se mostrará el ensamblador cuando el programa que se está ejecutando se asocia al depurador. Este parámetro reemplaza el parámetro EmitDebugInformation. Para obtener más información, vea /debug (Emitir información de depuración) (Opciones del compilador de C#). |
DefineConstants |
Parámetro String opcional. Define los símbolos de preprocesador. Para obtener más información, vea /define (Definición de preprocesador) (Opciones del compilador de C#). |
DelaySign |
Parámetro Boolean opcional. Si es true, especifica que desea un ensamblado con firma completa. Si es false, especifica que sólo desea incluir la clave pública en el ensamblado. Este parámetro no tiene ningún efecto a menos que se utilice con el parámetro KeyFile o el parámetro KeyContainer. Para obtener más información, vea /delaysign (Retardar la firma del ensamblado) (Opciones del compilador de C#). |
DisabledWarnings |
Parámetro String opcional. Especifica la lista de advertencias que se va a deshabilitar. Para obtener más información, vea /nowarn (Suprimir las advertencias especificadas) (Opciones del compilador de C#). |
DocumentationFile |
Parámetro String opcional. Procesa los comentarios de documentación generando un archivo XML. Para obtener más información, vea /doc (Procesar comentarios de documentación) (Opciones del compilador de C#). |
EmitDebugInformation |
Parámetro Boolean opcional. Si es true, la tarea genera información de depuración y la coloca en un archivo (.pdb) de base de datos del programa. Si es false, la tarea no emite ninguna información de depuración. El valor predeterminado es false. Para obtener más información, vea /debug (Emitir información de depuración) (Opciones del compilador de C#). |
ErrorReport |
Parámetro String opcional. Ofrece una forma cómoda de informar de un error interno de C# a Microsoft. Este parámetro puede tener el valor prompt, send o none. Si el parámetro está establecido en prompt, recibirá un mensaje cuando se produzca un error del compilador interno. El mensaje permite enviar electrónicamente un informe de errores a Microsoft. Si el parámetro está establecido en send, el informe de errores se envía automáticamente. Si el parámetro está establecido en none, el error sólo se notifica en el texto de salida del compilador. El valor predeterminado es none. Para obtener más información, vea /errorreport (Establecer el comportamiento de notificación de errores) (Opciones del compilador de C#). |
FileAlignment |
Parámetro Int32 opcional. Especifica el tamaño de las secciones del archivo de resultados. Para obtener más información, vea /filealign (Especificar la alineación de una sección) (Opciones del compilador de C#). |
GenerateFullPaths |
Parámetro Boolean opcional. Si es true, especifica la ruta de acceso absoluta al archivo en los resultados del compilador. Si es false, especifica el nombre del archivo. El valor predeterminado es false. Para obtener más información, vea /fullpaths (Especificar ruta completa en los resultados del compilador) (Opciones del compilador de C#). |
KeyContainer |
Parámetro String opcional. Especifica el nombre del contenedor de claves criptográficas. Para obtener más información, vea /keycontainer (Especificar contenedor de claves con nombre seguro) (Opciones del compilador de C#). |
KeyFile |
Parámetro String opcional. Especifica el nombre de archivo que contiene la clave criptográfica. Para obtener más información, vea /keyfile (Especificar archivo clave con nombre seguro) (Opciones del compilador de C#). |
LangVersion |
Parámetro String opcional. Especifica la versión del lenguaje que se va a utilizar. Para obtener más información, vea /langversion (Sintaxis compatible) (Opciones del compilador de C#). |
LinkResources |
Parámetro ITaskItem[] opcional. Crea un vínculo a un archivo de recursos de .NET Framework en el archivo de resultados, pero el archivo de recursos no se coloca en el archivo de resultados. Los elementos que se pasan a este parámetro pueden tener entradas opcionales de metadatos denominadas LogicalName y Access. LogicalName corresponde al parámetro identifier del modificador /linkresource, y Access corresponde al parámetro accessibility-modifier. Para obtener más información, vea /linkresource (Vincular a recursos de .NET Framework) (Opciones del compilador de C#). |
MainEntryPoint |
Parámetro String opcional. Especifica la ubicación del método Main. Para obtener más información, vea /main (Especificar la ubicación del método Main) (Opciones del compilador de C#). |
NoConfig |
Parámetro Boolean opcional. Si es true, indica al compilador que no compile con el archivo csc.rsp. Para obtener más información, vea /noconfig (Omitir csc.rsp) (Opciones del compilador de C#). |
NoLogo |
Parámetro Boolean opcional. Si es true, suprime la presentación de información de titular del compilador. Para obtener más información, vea /nologo (Suprimir la información de pancarta) (Opciones del compilador de C#). |
NoStandardLib |
Parámetro Boolean opcional. Si es true, evita la importación de mscorlib.dll, que define el espacio de nombres de sistema completo. Use este parámetro si desea definir o crear sus propios objetos y espacio de nombres de sistema. Para obtener más información, vea /nostdlib (No importar la biblioteca estándar) (Opciones del compilador de C#). |
Optimize |
Parámetro Boolean opcional. Si es true, habilita las optimizaciones. Si es false, deshabilita las optimizaciones. Para obtener más información, vea /optimize (Habilitar o deshabilitar optimizaciones) (Opciones del compilador de C#). |
OutputAssembly |
Parámetro de salida String opcional. Especifica el nombre del archivo resultante. Para obtener más información, vea /out (Establecer el nombre de archivo de los resultados) (Opciones del compilador de C#). |
Platform |
Parámetro String opcional. Especifica la plataforma del procesador de destino del archivo de resultados. Este parámetro puede tener el valor x86, x64 o anycpu. El valor predeterminado es anycpu. Para obtener más información, vea /platform (Especificar la plataforma de los resultados) (Opciones del compilador de C#). |
References |
Parámetro ITaskItem[] opcional. Hace que la tarea importe la información de tipo pública de los elementos especificados al proyecto actual. Para obtener más información, vea /reference (Importar metadatos) (Opciones del compilador de C#). Puede especificar un alias de referencia de Visual C# en un archivo de MSBuildagregando los Aliases de los metadatos al elemento "Reference" original. Por ejemplo, para establecer el alias "LS1" en la línea de comandos de CSC siguiente: utilizaría: |
Resources |
Parámetro ITaskItem[] opcional. Incrusta un archivo de recursos de .NET Framework en el archivo de resultados. Los elementos que se pasan a este parámetro pueden tener entradas opcionales de metadatos denominadas LogicalName y Access. LogicalName corresponde al parámetro identifier del modificador /resource, y Access corresponde al parámetro accessibility-modifier. Para obtener más información, vea /resource (Incrustar un archivo de recursos en el resultado) (Opciones del compilador de C#). |
ResponseFiles |
Parámetro String opcional. Especifica el archivo de respuesta que contiene los comandos para esta tarea. Para obtener más información, vea @ (Especificar archivo de respuesta) (Opciones del compilador de C#). |
Sources |
Parámetro ITaskItem[] opcional. Especifica uno o varios archivos de origen de Visual C#. |
TargetType |
Parámetro String opcional. Especifica el formato del archivo de resultados. Este parámetro puede tener un valor de library, que crea una biblioteca de códigos, exe, que crea una aplicación de consola, module, que crea un módulo, o winexe, que crea un programa de Windows. El valor predeterminado es library. Para obtener más información, vea /target (Especificar el formato del archivo de resultados) (Opciones del compilador de C#). |
Timeout |
Parámetro Int32 opcional. Especifica el tiempo, en milisegundos, tras el cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue; es decir, no existe tiempo de espera. |
ToolPath |
Parámetro String opcional. Especifica la ubicación desde la que la tarea carga el archivo ejecutable subyacente (CSC.exe). Si no se especifica este parámetro, la tarea utiliza la ruta de acceso de instalación del SDK correspondiente a la versión de Framework que está ejecutando MSBuild. |
TreatWarningsAsErrors |
Parámetro Boolean opcional. Si es true, trata todas las advertencias como errores. Para obtener más información, vea /warnaserror (Tratar advertencias como errores) (Opciones del compilador de C#). |
UseHostCompilerIfAvailable |
Parámetro Boolean opcional. Indica a la tarea que utilice el objeto de compilador en proceso, si está disponible. Utilizado únicamente por Visual Studio. |
Utf8Output |
Parámetro Boolean opcional. Registra los resultados del compilador mediante la codificación UTF-8. Para obtener más información, vea /utf8output (Mostrar mensajes del compilador con UTF-8) (Opciones del compilador de C#). |
WarningLevel |
Parámetro Int32 opcional. Especifica el nivel de advertencia que debe mostrar el compilador. Para obtener más información, vea /warn (Especificar el nivel de advertencia) (Opciones del compilador de C#). |
WarningsAsErrors |
Parámetro String opcional. Especifica una lista de advertencias que se tratarán como errores. Para obtener más información, vea /warnaserror (Tratar advertencias como errores) (Opciones del compilador de C#). Este parámetro reemplaza el parámetro TreatWarningsAsErrors. |
WarningsNotAsErrors |
Parámetro String opcional. Especifica una lista de advertencias que no se tratarán como errores. Para obtener más información, vea /warnaserror (Tratar advertencias como errores) (Opciones del compilador de C#). Este parámetro sólo resulta útil si el parámetro TreatWarningsAsErrors se establece en true. |
WarningLevel |
Parámetro Int32 opcional. Establece el nivel de advertencia adecuado, de 0 a 4. Para obtener más información, vea /warn (Especificar el nivel de advertencia) (Opciones del compilador de C#). |
Win32Icon |
Parámetro String opcional. Inserta un archivo .ico en el ensamblado, que da el aspecto deseado al archivo de resultados en el Explorador de Windows. Para obtener más información, vea /win32res (Importar un archivo .ico) (Opciones del compilador de C#). |
Win32Resource |
Parámetro String opcional. Inserta un recurso de Win32 archivo (.res) en el archivo de resultados. Para obtener más información, vea /win32res (Importar un archivo de recursos Win32) (Opciones del compilador de C#). |
Ejemplo
En el siguiente ejemplo se utiliza la tarea Csc para compilar una aplicación ejecutable a partir de los archivos de código fuente en la colección de elementos Compile.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />