Compartir a través de

CL (Tarea)

  • Artículo

Incluye la herramienta de compilador de Visual C++, cl.exe.El compilador genera archivos ejecutables (.exe), archivos de biblioteca de vínculos dinámicos (.dll) o un módulo de código (.archivos netmodule).Para obtener más información, vea Opciones del compilador.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea CL.La mayoría de los parámetros de tarea, y algunos conjuntos de parámetros, corresponden a una opción de la línea de comandos.

Parámetro

Descripción

AdditionalIncludeDirectories

Parámetro opcional de tipo String[].

Agrega un directorio a la lista de directorios en los que se buscan archivos de inclusión.

Para obtener más información, vea /I (Directorios de inclusión adicionales).

AdditionalOptions

Parámetro opcional de tipo String.

Una lista de opciones de la línea de comandos.Por ejemplo, "/opción1 /opción2 /opción#".Utilice este parámetro para especificar opciones de la línea de comandos que no están representadas por ningún otro parámetro de tarea.

Para obtener más información, vea Opciones del compilador.

AdditionalUsingDirectories

Parámetro opcional de tipo String[].

Especifica un directorio en el que el compilador debe buscar para resolver las referencias de archivos que se transfieran a la directiva #using.

Para obtener más información, vea /AI (Especificar directorios de metadatos).

AlwaysAppend

Parámetro opcional de tipo String.

Una cadena que siempre se emite en la línea de comandos.Su valor predeterminado es "/c".

AssemblerListingLocation

Crea un archivo de lista que contiene el código de ensamblado.

Para obtener más información, vea la opción /Fa de /FA, /Fa (Archivo de lista).

AssemblerOutput

Parámetro opcional de tipo String.

Crea un archivo de lista que contiene el código de ensamblado.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
NoListing<none>
AssemblyCode/FA
AssemblyAndMachineCode/FAc
AssemblyAndSourceCode/FAs
All/FAcs

Para obtener más información, vea las opciones /FA, /FAc, /FAs y /FAcs de /FA, /Fa (Archivo de lista).

BasicRuntimeChecks

Parámetro opcional de tipo String.

Habilita y deshabilita la característica de comprobaciones de errores en tiempo de ejecución, junto con el pragma runtime_checks.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Default<none>
StackFrameRuntimeCheck/RTCs
UninitializedLocalUsageCheck/RTCu
EnableFastChecks/RTC1

Para obtener más información, vea /RTC (Comprobaciones de errores en tiempo de ejecución).

BrowseInformation

Parámetro opcional de tipo Boolean.

Si es true, crea un archivo de información de examen.

Para obtener más información, vea la opción /FR de /FR, /Fr (Crear archivo .Sbr).

BrowseInformationFile

Parámetro opcional de tipo String.

Especifica un nombre de archivo para el archivo de información de examen.

Para obtener más información, vea el parámetro BrowseInformation de esta tabla, y también vea /FR, /Fr (Crear archivo .Sbr).

BufferSecurityCheck

Parámetro opcional de tipo Boolean.

Si es true, detecta algunas saturaciones de búfer que sobrescriben la dirección de retorno, una técnica común para aprovechar código que no aplica restricciones de tamaño de búfer.

Para obtener más información, vea /GS (Comprobación de seguridad del búfer).

BuildingInIDE

Parámetro opcional de tipo Boolean.

Si es true, indica que el IDE invoca a MSBuild.De lo contrario, MSBuild se invoca en la línea de comandos.

CallingConvention

Parámetro opcional de tipo String.

Especifica la convención de llamada, que determina el orden en que se insertan en la pila los argumentos de una función, si la función llamadora o la llamada quita los argumentos de la pila al finalizar la llamada, y la convención para creación de nombres representativos que utiliza el compilador para identificar funciones individuales.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Cdecl/Gd
FastCall/Gr
StdCall/Gz

Para obtener más información, vea /Gd, /Gr, /Gz (Convención de llamada).

CompileAs

Parámetro opcional de tipo String.

Especifica si se compila el archivo de entrada como un archivo de origen de C o C++.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Default<none>
CompileAsC/TC
CompileAsCpp/TP

Para obtener más información, vea /Tc, /Tp, /TC, /TP (Especificar el tipo de archivo de código fuente).

CompileAsManaged

Parámetro opcional de tipo String.

Permite a las aplicaciones y a los componentes utilizar las características de Common Language Runtime (CLR).

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
false<none>
true/clr
Pure/clr:pure
Safe/clr:safe
OldSyntax/clr:oldSyntax

Para obtener más información, vea /clr (Compilación de Common Language Runtime).

CreateHotpatchableImage

Parámetro opcional de tipo Boolean.

Si es true, indica al compilador que prepare una imagen para la aplicación de una revisión reciente.Este parámetro asegura que la primera instrucción de cada función es dos bytes, lo que se requiere para la revisión en caliente.

Para obtener más información, vea /hotpatch (Crear una imagen a la que se puede aplicar una revisión reciente).

DebugInformationFormat

Parámetro opcional de tipo String.

Selecciona el tipo de información de depuración que se crea para un programa y si esta información se conserva en archivos objeto (.obj) o en una base de datos de programa (PDB).

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
OldStyle/Z7
ProgramDatabase/Zi
EditAndContinue/ZI

Para obtener más información, vea /Z7, /Zi, /ZI (Formato de la información de depuración).

DisableLanguageExtensions

Parámetro opcional de tipo Boolean.

Si es true, indica al compilador que emita un error para las construcciones de lenguaje que no son compatibles con ANSI C o ANSI C++.

Para obtener más información, vea la opción /Za de /Za, /Ze (Deshabilitar extensiones de lenguaje).

DisableSpecificWarnings

Parámetro opcional de tipo String[].

Deshabilita los números de advertencia que se especifican en una lista delimitada por punto y comas.

Para obtener más información, vea la opción /wd de /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Nivel de advertencia).

EnableEnhancedInstructionSet

Parámetro opcional de tipo String.

Especifica la arquitectura de la generación de código que usa las instrucciones de Extensiones SIMD de transmisión por secuencias (SSE) y Extensiones SIMD de transmisión por secuencias 2 (SSE2).

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
StreamingSIMDExtensions/arch:SSE
StreamingSIMDExtensions2/arch:SSE2

Para obtener más información, vea /arch (x86).

EnableFiberSafeOptimizations

Parámetro opcional de tipo Boolean.

Si es true, admite la seguridad de fibras para los datos asignados mediante el almacenamiento local de subprocesos estáticos, es decir, datos asignados mediante __declspec(thread).

Para obtener más información, vea /GT (Admitir el almacenamiento local de subprocesos para fibra).

EnablePREfast

Parámetro opcional de tipo Boolean.

Si es true, habilita el análisis de código.

Para obtener más información, vea /analyze (análisis de código).

ErrorReporting

Parámetro opcional de tipo String.

Permite proporcionar directamente a Microsoft la información sobre el error interno del compilador.De forma predeterminada, el valor de las compilaciones del IDE es Prompt y el valor de las compilaciones de línea de comandos es Queue.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
None/errorReport:none
Prompt/errorReport:prompt
Queue/errorReport:queue
Send/errorReport:send

Para obtener más información, vea /errorReport (Informar de los errores del compilador).

ExceptionHandling

Parámetro opcional de tipo String.

Especifica el modelo de control de excepciones que se va a ser utilizado por el compilador.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
false<none>
Async/EHa
Sync/EHsc
SyncCThrow/EHs

Para obtener más información, vea /EH (Modelo de control de excepciones).

ExpandAttributedSource

Parámetro opcional de tipo Boolean.

Si es true, crea un archivo de lista que tiene atributos expandidos insertados en el archivo de origen.

Para obtener más información, vea /Fx (Combinar código insertado).

FavorSizeOrSpeed

Parámetro opcional de tipo String.

Especifica si se da prioridad al tamaño o a la velocidad del código.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Neither<none>
Size/Os
Speed/Ot

Para obtener más información, vea /Os, /Ot (Favorecer código pequeño, favorecer código rápido).

FloatingPointExceptions

Parámetro opcional de tipo Boolean.

Si es true, habilita el modelo de excepción de punto flotante fiable.Se producirán excepciones inmediatamente una vez desencadenado.

Para obtener más información, vea la opción /fp:except de /fp (Especificar comportamiento de punto flotante).

FloatingPointModel

Parámetro opcional de tipo String.

Establece el modelo de punto flotante.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Precise/fp:precise
Strict/fp:strict
Fast/fp:fast

Para obtener más información, vea /fp (Especificar comportamiento de punto flotante).

ForceConformanceInForLoopScope

Parámetro opcional de tipo Boolean.

Si es true, implementa el comportamiento estándar de C++ en b80153d8(v=vs.110).mdpara bucles que usan extensiones de Microsoft(/Ze).

Para obtener más información, vea /Zc:forScope (Forzar ajuste en el ámbito del bucle For).

ForcedIncludeFiles

Parámetro String[] opcional.

Hace que el preprocesador procese uno o varios archivos de encabezado especificados.

Para obtener más información, vea /FI (Dar nombre al archivo de inclusión obligatorio).

ForcedUsingFiles

Parámetro String[] opcional.

Hace que el preprocesador procese uno o varios archivos #using especificados.

Para obtener más información, vea /FU (Asignar nombre al archivo #using obligatorio).

FunctionLevelLinking

Parámetro Boolean opcional.

Si es true, permite que el compilador empaquete funciones individuales en forma de funciones empaquetadas (COMDAT).

Para obtener más información, vea /Gy (Habilitar vinculación en el nivel de función).

GenerateXMLDocumentationFiles

Parámetro Boolean opcional.

Si es true, hace que el compilador procese comentarios de documentación en archivos de código fuente, y la creación de un archivo .xdc por cada archivo de código fuente que tenga comentarios de documentación.

Para obtener más información, vea /doc (Procesar comentarios de documentación) (C/C++).También vea el parámetro XMLDocumentationFileName de esta tabla.

IgnoreStandardIncludePath

Parámetro Boolean opcional.

Si es true, impide que el compilador busque archivos de inclusión en los directorios especificados en las variables de entorno PATH e INCLUDE.

Para obtener más información, vea /X (Omitir rutas de acceso de inclusión estándar).

InlineFunctionExpansion

Parámetro String opcional.

Especifica el nivel de expansión de la función alineada para la compilación.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Default<none>
Disabled/Ob0
OnlyExplicitInline/Ob1
AnySuitable/Ob2

Para obtener más información, vea /Ob (Expansión de funciones inline).

IntrinsicFunctions

Parámetro Boolean opcional.

Si es true, reemplaza algunas llamadas a función con formas intrínsecas o especiales de la función, que aumentan la velocidad de ejecución de la aplicación.

Para obtener más información, vea /Oi (Generar funciones intrínsecas).

MinimalRebuild

Parámetro Boolean opcional.

Si es true, habilita la recompilación mínima, que determina si se deben volver a compilar los archivos de origen de C++ que incluyen definiciones de clases de C++ modificadas (almacenadas en archivos de encabezado (.h)).

Para obtener más información, vea /Gm (Habilitar recompilación mínima).

MultiProcessorCompilation

Parámetro Boolean opcional.

Si es true, utilice varios procesadores para compilar.Este parámetro crea un proceso para cada procesador efectivo en su equipo.

Para obtener más información, vea /MP (Compilar con varios procesos).También, vea el parámetro ProcessorNumber de esta tabla.

ObjectFileName

Parámetro String opcional.

Especifica un nombre de archivo objeto (.obj) o un directorio que debe utilizarse en lugar del valor predeterminado.

Para obtener más información, vea /Fo (Nombre del archivo objeto).

ObjectFiles

Parámetro String[] opcional.

Una lista de archivos objeto.

OmitDefaultLibName

Parámetro Boolean opcional.

Si es true, omite el nombre predeterminado de la biblioteca en tiempo de ejecución de C desde el archivo objeto (.obj).De forma predeterminada, el compilador sitúa el nombre de la biblioteca en el archivo .obj para dirigir el vinculador a la biblioteca correcta.

Para obtener más información, vea /Zl (Omitir nombres de biblioteca predeterminada).

OmitFramePointers

Parámetro Boolean opcional.

Si es true, suprime la creación de punteros de marcos en la pila de llamadas.

Para obtener más información, vea /Oy (Omisión de puntero de marco).

OpenMPSupport

Parámetro Boolean opcional.

Si es true, hace que el compilador procese cláusulas y directivas OpenMP.

Para obtener más información, vea /openmp (Habilitar la compatibilidad con OpenMP 2.0).

Optimization

Parámetro String opcional.

Especifica varias optimizaciones del código para la velocidad y tamaño.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Disabled/Od
MinSpace/O1
MaxSpeed/O2
Full/Ox

Para obtener más información, vea /O (Opciones) (Optimizar código).

PrecompiledHeader

Parámetro String opcional.

Cree o utilice un archivo de encabezado precompilado (.pch) durante la compilación.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
NotUsing<none>
Create/Yc
Use/Yu

Para obtener más información, vea /Yc (Crear archivo de encabezado precompilado) y /Yu (Utilizar el archivo de encabezado precompilado).También, vea los parámetros PrecompiledHeaderFile y PrecompiledHeaderOutputFile de esta tabla.

PrecompiledHeaderFile

Parámetro String opcional.

Especifica un nombre de archivo de encabezado precompilado que se desea crear o utilizar.

Para obtener más información, vea /Yc (Crear archivo de encabezado precompilado) y /Yu (Utilizar el archivo de encabezado precompilado).

PrecompiledHeaderOutputFile

Parámetro String opcional.

Especifica un nombre de ruta de acceso para un encabezado precompilado en lugar de utilizar el nombre de ruta de acceso predeterminado.

Para obtener más información, vea /Fp (Dar nombre al archivo .Pch).

PreprocessKeepComments

Parámetro Boolean opcional.

Si es true, conserva los comentarios durante el preprocesamiento.

Para obtener más información, vea /C (Conservar los comentarios durante el preprocesamiento).

PreprocessorDefinitions

Parámetro String[] opcional.

Define un símbolo del preprocesamiento para un archivo de código fuente.

Para obtener más información, vea /D (Definiciones de preprocesador).

PreprocessOutput

Parámetro ITaskItem[] opcional.

Define una matriz de elementos de preprocesador de salida que las tareas pueden usar y emitir.

PreprocessOutputPath

Parámetro String opcional.

Especifica el nombre del archivo de salida en el que el parámetro PreprocessToFile escribe la salida preprocesada.

Para obtener más información, vea /Fi (Preprocesar el nombre del archivo de salida).

PreprocessSuppressLineNumbers

Parámetro Boolean opcional.

Si es true, preprocesa archivos de origen de C y C++ y copia los archivos preprocesados en el dispositivo de salida estándar.

Para obtener más información, vea /EP (Preprocesar para stdout sin directivas #line).

PreprocessToFile

Parámetro Boolean opcional.

Si es true, preprocesa archivos de origen de C y C++ y escribe el resultado preprocesado en un archivo.

Para obtener más información, vea /P (Preprocesar y escribir en un archivo).

ProcessorNumber

Parámetro Integer opcional.

Especifica el número máximo de procesadores que se van a utilizar en una compilación de multiprocesador.Utilice este parámetro en combinación con el parámetro MultiProcessorCompilation.

ProgramDataBaseFileName

Parámetro String opcional.

Especifica un nombre de archivo para el archivo de base de datos de programa (PDB).

Para obtener más información, vea /Fd (Nombre del archivo de base de datos del programa).

RuntimeLibrary

Parámetro String opcional.

Indica si un módulo multiproceso es un archivo DLL, y selecciona versiones de lanzamiento o de depuración de la biblioteca en tiempo de ejecución.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
MultiThreaded/MT
MultiThreadedDebug/MTd
MultiThreadedDLL/MD
MultiThreadedDebugDLL/MDd

Para obtener más información, vea /MD, /MT, /LD (Utilizar la biblioteca en tiempo de ejecución).

RuntimeTypeInfo

Parámetro Boolean opcional.

Si es true, se agrega código para comprobar los tipos de objeto de C++ en tiempo de ejecución (información de tipo en tiempo de ejecución).

Para obtener más información, vea /GR (Habilitar la información de tipo en tiempo de ejecución).

ShowIncludes

Parámetro Boolean opcional.

Si es true, hace que el compilador genere una lista de los archivos de inclusión.

Para obtener más información, vea /showIncludes (Enumerar archivos de inclusión).

SmallerTypeCheck

Parámetro Boolean opcional.

Si es true, notifica un error en tiempo de ejecución si se asigna un valor a un tipo de datos menor y produce una pérdida de datos.

Para obtener más información, vea la opción /RTCc de /RTC (Comprobaciones de errores en tiempo de ejecución).

Sources

Parámetro ITaskItem[] requerido.

Especifica una lista de archivos de origen separada por espacios.

StringPooling

Parámetro Boolean opcional.

Si es true, permite al compilador crear una copia de cadenas idénticas en la imagen del programa.

Para obtener más información, vea /GF (Eliminar cadenas duplicadas).

StructMemberAlignment

Parámetro String opcional.

Especifica la alineación de bytes para todos los miembros de una estructura.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
Default/Zp1
1Byte/Zp1
2Bytes/Zp2
4Bytes/Zp4
8Bytes/Zp8
16Bytes/Zp16

Para obtener más información, vea /Zp (Alineación de miembros de estructura).

SuppressStartupBanner

Parámetro Boolean opcional.

Si es true, evita la presentación del copyright y del mensaje de número de versión cuando la tarea se inicia.

Para obtener más información, vea /NOLOGO (Suprimir el titular de inicio) (C/C++).

TrackerLogDirectory

Parámetro String opcional.

Especifica el directorio intermedio donde se almacenan los registros de seguimiento de esta tarea.

Para obtener más información, vea los parámetros TLogReadFiles y TLogWriteFiles de esta tabla.

TreatSpecificWarningsAsErrors

Parámetro String[] opcional.

Trata la lista de advertencias del compilador especificada como errores.

Para obtener más información, vea la opción /wen de /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Nivel de advertencia).

TreatWarningAsError

Parámetro Boolean opcional.

Si es true, trata todas las advertencias del compilador como errores.

Para obtener más información, vea la opción /WX de /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Nivel de advertencia).

TreatWChar_tAsBuiltInType

Parámetro Boolean opcional.

Si es true, trate el tipo wchar_t como un tipo nativo.

Para obtener más información, vea /Zc:wchar_t (wchar_t es un tipo nativo).

UndefineAllPreprocessorDefinitions

Parámetro Boolean opcional.

Si es true, anula la definición de los símbolos específicos de Microsoft definidos por el compilador.

Para obtener más información, vea la opción /u de /U, /u (Anular la definición de símbolos).

UndefinePreprocessorDefinitions

Parámetro String[] opcional.

Especifica una lista de uno o más símbolos de preprocesador cuya definición se desea anular.

Para obtener más información, vea la opción /U de /U, /u (Anular la definición de símbolos).

UseFullPaths

Parámetro Boolean opcional.

Si es true, hace que el compilador muestre la ruta de acceso completa de archivos de código fuente que se ha pasado al compilador en diagnósticos.

Para obtener más información, vea /FC (Ruta de acceso completa de archivo de código fuente en diagnósticos).

UseUnicodeForAssemblerListing

Parámetro Boolean opcional.

Si es true, hace que se cree el archivo de salida en formato UTF-8.

Para obtener más información, vea la opción /FAu de /FA, /Fa (Archivo de lista).

WarningLevel

Parámetro String opcional.

Especifica el nivel máximo de advertencia que va a generar el compilador.

Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de la línea de comandos.

ValorOpción de la línea de comandos
TurnOffAllWarnings/W0
Level1/W1
Level2/W2
Level3/W3
Level4/W4
EnableAllWarnings/Wall

Para obtener más información, vea la opción /Wn de /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Nivel de advertencia).

WholeProgramOptimization

Parámetro Boolean opcional.

Si es true, habilita la optimización completa del programa.

Para obtener más información, vea /GL (Optimización de todo el programa).

XMLDocumentationFileName

Parámetro String opcional.

Especifica el nombre de los archivos de documentación XML generados.Este parámetro puede ser un archivo o nombre de directorio.

Para obtener más información, vea el argumento name en /doc (Procesar comentarios de documentación) (C/C++).También vea el parámetro GenerateXMLDocumentationFiles de esta tabla.

MinimalRebuildFromTracking

Parámetro Boolean opcional.

Si es true, se realiza una compilación incremental con seguimiento; si es false, se realiza una recompilación.

TLogReadFiles

Parámetro ITaskItem[] opcional.

Especifica una matriz de elementos que representa los registros de seguimiento de archivo de lectura.

Un registro de seguimiento de archivo de lectura (.tlog) contiene los nombres de los archivos de entrada que son leídos por una tarea, y es utilizado por el sistema de compilación del proyecto para apoyar las compilaciones incrementales.Para obtener más información, vea los parámetros TrackerLogDirectory y TrackFileAccess de esta tabla.

TLogWriteFiles

Parámetro ITaskItem[] opcional.

Especifica una matriz de elementos que representa los registros de seguimiento de archivo de escritura.

Un registro de seguimiento de archivo de escritura (.tlog) contiene los nombres de los archivos de salida que se escriben en una tarea, y es utilizado por el sistema de compilación del proyecto para apoyar las compilaciones incrementales.Para obtener más información, vea los parámetros TrackerLogDirectory y TrackFileAccess de esta tabla.

TrackFileAccess

Parámetro Boolean opcional.

Si es true, realiza un seguimiento de los modelos de acceso a archivos.

Para obtener más información, vea los parámetros TLogReadFiles y TLogWriteFiles de esta tabla.

Vea también

Otros recursos

Referencia de tareas de MSBuild