Csc (Tarea)
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 para buscar referencias. Para obtener más información, vea /lib (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 (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 (Opciones del compilador de C#). |
ApplicationConfiguration |
Parámetro String opcional. Especifica el archivo de configuración de la aplicación que contiene la configuración de enlace del ensamblado. |
BaseAddress |
Parámetro String opcional. Especifica la dirección base preferida donde se va a 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 (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 (Opciones del compilador de C#). |
CodePage |
Parámetro Int32 opcional. Especifica la página de códigos que se va a utilizar para todos los archivos de código fuente en la compilación. Para obtener más información, vea /codepage (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 (Opciones del compilador de C#). |
DefineConstants |
Parámetro String opcional. Define los símbolos de preprocesador. Para obtener más información, vea /define (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 (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 (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 (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 (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 (Opciones del compilador de C#). |
FileAlignment |
Parámetro Int32 opcional. Especifica el tamaño de las secciones del archivo de salida. Para obtener más información, vea /filealign (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 (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 (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 (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 (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 salida, pero el archivo de recursos no se coloca en el archivo de salida. 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 (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 (Opciones del compilador de C#). |
ModuleAssemblyName |
Parámetro String opcional. Especifica el nombre del ensamblado del que formará parte este módulo. |
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 (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 (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 (Opciones del compilador de C#). |
NoWin32Manifest |
Parámetro Boolean opcional. Si es true, no incluya el manifiesto de Win32 predeterminado. |
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 (Opciones del compilador de C#). |
OutputAssembly |
Parámetro de salida String opcional. Especifica el nombre del archivo de salida. Para obtener más información, vea /out (Opciones del compilador de C#). |
PdbFile |
Parámetro String opcional. Especifica el nombre de archivo de información de depuración. El nombre predeterminado es el nombre de archivo de salida con una extensión .pdb. |
Platform |
Parámetro String opcional. Especifica la plataforma del procesador de destino del archivo de salida. Este parámetro puede tener el valor x86, x64 o anycpu. El valor predeterminado es anycpu. Para obtener más información, vea /platform (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 (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 salida. 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 (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 @ (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 salida. 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 (Opciones del compilador de C#). |
TreatWarningsAsErrors |
Parámetro Boolean opcional. Si es true, trata todas las advertencias como errores. Para obtener más información, vea /warnaserror (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. Esta propiedad se utiliza únicamente en 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 (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 (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 (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 (Opciones del compilador de C#). Este parámetro sólo resulta útil si el parámetro TreatWarningsAsErrors se establece en true. |
Win32Icon |
Parámetro String opcional. Inserta un archivo .ico en el ensamblado, que proporciona al archivo de salida la apariencia deseada en el Explorador de archivos. Para obtener más información, vea /win32icon (Opciones del compilador de C#). |
Win32Manifest |
Parámetro String opcional. Especifica el manifiesto Win32 que se desea incluir. |
Win32Resource |
Parámetro String opcional. Inserta un recurso de Win32 archivo (.res) en el archivo de salida. Para obtener más información, vea /win32res (Opciones del compilador de C#). |
Comentarios
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase Microsoft.Build.Tasks.ManagedCompiler, que hereda de la clase ToolTaskExtension, que a su vez hereda de la clase ToolTask. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea ToolTaskExtension (Clase base).
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" />