Compartir a través de

Csc (Tarea)

  • Artículo

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 debe utilizarse 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:

csc /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

utilizaría:

<Reference Include="MyCodeLibrary">
  <Aliases>LS1</Aliases>
</Reference>

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. 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 (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 da el aspecto deseado al archivo de salida en el Explorador de Windows. 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" />

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild