Tarefa de CL

Encapsula a ferramenta do compilador Visual C++, cl. O compilador produz arquivos executáveis (. exe), arquivos de biblioteca de vínculo dinâmico (. dll) ou módulo de código (. arquivos netmodule). Para obter mais informações, consulte Opções do compilador.

Parâmetros

A tabela a seguir descreve os parâmetros da CL de tarefas. A maioria dos parâmetros da tarefa e alguns conjuntos de parâmetros, correspondem a uma opção de linha de comando.

Parâmetro	Descrição
AdditionalIncludeDirectories	Parâmetro de [] String opcional. Adiciona uma pasta à lista de diretórios que são pesquisadas por arquivos de inclusão. Para obter mais informações, consulte /I (adicionais incluem a diretórios).
AdditionalOptions	Parâmetro de seqüência de caracteres opcional. Uma lista de opções de linha de comando. Por exemplo, "/Opção1 /2 /opção #". Use esse parâmetro para especificar as opções de linha de comando que não são representadas por qualquer outro parâmetro da tarefa. Para obter mais informações, consulte Opções do compilador.
AdditionalUsingDirectories	Parâmetro de [] String opcional. Especifica um diretório em que o compilador pesquisará para resolver referências de arquivo passaram para o #using diretiva. Para obter mais informações, consulte /AI (especificam diretórios de metadados).
AlwaysAppend	Parâmetro de seqüência de caracteres opcional. Uma seqüência de caracteres que sempre obtém emitida na linha de comando. O valor padrão é "/c".
AssemblerListingLocation	Cria um arquivo de listagem que contém o código de assembly. Para obter mais informações, consulte o /Fa opção na / FA, /Fa (arquivo de listagem).
AssemblerOutput	Parâmetro de seqüência de caracteres opcional. Cria um arquivo de listagem que contém o código de assembly. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando NoListing<none>. AssemblyCode/FA AssemblyAndMachineCode/FAc AssemblyAndSourceCode/FAs All/FAcs Para obter mais informações, consulte o /FA, /FAc, /FAs, e /FAcs Opções / FA, /Fa (arquivo de listagem).
BasicRuntimeChecks	Parâmetro de seqüência de caracteres opcional. Habilita e desabilita o recurso de verificações de erro de tempo de execução, juntamente com o runtime_checks pragma. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Default<none>. StackFrameRuntimeCheck/RTCs UninitializedLocalUsageCheck/RTCu EnableFastChecks/RTC1 Para obter mais informações, consulte / RTC (verificações de erro de tempo de execução).
BrowseInformation	Em parâmetro booleano opcional. Se true, cria um arquivo de informações de procura. Para obter mais informações, consulte o /FR opção na / FR, /Fr (criar.Arquivo SBR).
BrowseInformationFile	Parâmetro de seqüência de caracteres opcional. Especifica um nome de arquivo para o arquivo de informações de procura. Para obter mais informações, consulte o BrowseInformation parâmetro nesta tabela, e consulte também / FR, /Fr (criar.Arquivo SBR).
BufferSecurityCheck	Em parâmetro booleano opcional. Se true, que detecta alguns estouros de buffer que substituir o endereço do remetente, uma técnica comum para explorar o código que não impõe restrições de tamanho de buffer. Para obter mais informações, consulte /GS (verificação de segurança de buffer).
BuildingInIDE	Em parâmetro booleano opcional. Se true, indica que MSBuild é chamado pela IDE. Caso contrário, MSBuild é invocado na linha de comando.
CallingConvention	Parâmetro de seqüência de caracteres opcional. Especifica a convenção de chamada, que determina a ordem na qual função argumentos são colocados na pilha, se a função do chamador ou a função chamada remove os argumentos da pilha no final da chamada e a convenção de decoração de nome que o compilador usa para identificar as funções individuais. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Cdecl/Gd FastCall/Gr StdCall/Gz Para obter mais informações, consulte / Gd, /Gr, /Gz (convenção de chamada).
CompileAs	Parâmetro de seqüência de caracteres opcional. Especifica se deve compilar o arquivo de entrada como um arquivo de código-fonte c ou C++. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Default<none>. CompileAsC/TC CompileAsCpp/TP Para obter mais informações, consulte / Tc, /Tp, /TC, /TP (Especifica o tipo de arquivo de origem).
CompileAsManaged	Parâmetro de seqüência de caracteres opcional. Permite que aplicativos e componentes usar os recursos do common language runtime (CLR). Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando false<none>. true/clr Pure/clr:pure Safe/clr:safe OldSyntax/clr:oldSyntax Para obter mais informações, consulte /CLR (common Language Runtime Compilation).
CreateHotpatchableImage	Em parâmetro booleano opcional. Se true, que informa o compilador para preparar uma imagem para hot patching. Este parâmetro garante que a primeira instrução da cada função de dois bytes, que é necessário para o hot patching. Para obter mais informações, consulte /hotpatch (criar imagem de Hotpatchable).
DebugInformationFormat	Parâmetro de seqüência de caracteres opcional. Seleciona o tipo de informações de depuração criadas para o seu programa e se essas informações são mantidas em arquivos de objeto (. obj) ou em um banco de dados do programa (PDB). Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando OldStyle/Z7 ProgramDatabase/Zi EditAndContinue/ZI Para obter mais informações, consulte / /Z7, /Zi, /ZI (formato informações de depuração).
DisableLanguageExtensions	Em parâmetro booleano opcional. Se true, que informa o compilador para emitir um erro de construções de linguagem que são não é compatível com ANSI C ou C++ de ANSI. Para obter mais informações, consulte o /Za opção na / Za, /Ze (linguagem de desabilitar extensões).
DisableSpecificWarnings	Parâmetro de [] String opcional. Desativa os números de aviso são especificados em uma lista delimitada por ponto e vírgula. Para obter mais informações, consulte o /wd opção na /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).
EnableEnhancedInstructionSet	Parâmetro de seqüência de caracteres opcional. Especifica a arquitetura para a geração de código que usa o Streaming SIMD Extensions (SSE) e instruções de Streaming SIMD Extensions 2 (SSE2). Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando StreamingSIMDExtensions/arch:SSE StreamingSIMDExtensions2/arch:SSE2 Para obter mais informações, consulte /arch (arquitetura de CPU mínimo).
EnableFiberSafeOptimizations	Em parâmetro booleano opcional. Se true, segurança de fibra para dados alocados por meio de armazenamento de local de thread estático, ou seja, os dados alocados por meio de suporte __declspec(thread). Para obter mais informações, consulte /GT (armazenamento Local de segmento de suporte de fibra segura).
EnablePREfast	Em parâmetro booleano opcional. Se true, ative a análise de código. Para obter mais informações, consulte /Analyze (análise de código da empresa).
ErrorReporting	Parâmetro de seqüência de caracteres opcional. Permite que você fornecer informações de erro (ICE) interno do compilador diretamente à Microsoft. Por padrão, a configuração em compilações do IDE é Prompt e a configuração em compilações de linha de comando for Queue. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando None/errorReport:none Prompt/errorReport:prompt Queue/errorReport:queue Send/errorReport:send Para obter mais informações, consulte /ErrorReport (relatório de erros do compilador interno).
ExceptionHandling	Parâmetro de seqüência de caracteres opcional. Especifica o modelo de tratamento de exceções a ser utilizado pelo compilador. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando false<none>. Async/EHa Sync/EHsc SyncCThrow/EHs Para obter mais informações, consulte /EH (modelo de manipulação de exceção).
ExpandAttributedSource	Em parâmetro booleano opcional. Se true, cria um arquivo de listagem que expandiu atributos injetados no arquivo de origem. Para obter mais informações, consulte /FX (código injetado de mesclagem).
FavorSizeOrSpeed	Parâmetro de seqüência de caracteres opcional. Especifica se deve favorecer a velocidade de tamanho ou o código do código. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Neither<none>. Size/Os Speed/Ot Para obter mais informações, consulte / /Ot (código de favor pequena, código de favor rápido) Os,.
FloatingPointExceptions	Em parâmetro booleano opcional. Se true, que permite que o modelo de exceção de ponto flutuante confiável. Exceções serão geradas imediatamente depois que são acionados. Para obter mais informações, consulte o /fp:except opção na /FP (Especifica o comportamento de ponto flutuante).
FloatingPointModel	Parâmetro de seqüência de caracteres opcional. Define a flutuação modelo de ponto. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Precise/fp:precise Strict/fp:strict Fast/fp:fast Para obter mais informações, consulte /FP (Especifica o comportamento de ponto flutuante).
ForceConformanceInForLoopScope	Em parâmetro booleano opcional. Se true, que implementa o comportamento padrão do C++ no para loops de extensões do Microsoft (/Ze). Para obter mais informações, consulte /ZC:forScope (forçar conformidade no escopo de Loop).
ForcedIncludeFiles	Opcional String[] parâmetro. Faz com que o pré-processador processar um ou mais arquivos de cabeçalho especificado. Para obter mais informações, consulte /Fi (nome forçado incluem o arquivo).
ForcedUsingFiles	Opcional String[] parâmetro. Faz com que o pré-processador para processar uma ou mais especificado #using arquivos. Para obter mais informações, consulte /Fu (nome forçado # using do arquivo).
FunctionLevelLinking	Opcional Boolean parâmetro. Se true, permite que o compilador funções individuais do pacote na forma de funções de pacotes (COMDATs). Para obter mais informações, consulte /GY (nível de função para ativar a vinculação).
GenerateXMLDocumentationFiles	Opcional Boolean parâmetro. Se true, faz o compilador comentários de documentação do processo em arquivos de código de origem e para criar um arquivo de .xdc para cada arquivo de código-fonte que tenha comentários de documentação. Para obter mais informações, consulte /doc (processo documentação comentários) (C/C++). Consulte também o XMLDocumentationFileName parâmetro na tabela.
IgnoreStandardIncludePath	Opcional Boolean parâmetro. Se true, impede que o compilador procure por arquivos de inclusão nas pastas especificadas no caminho e incluir variáveis de ambiente. Para obter mais informações, consulte /X (Ignorar padrão incluem caminhos).
InlineFunctionExpansion	Opcional String parâmetro. Especifica o nível de expansão da função in-line para a compilação. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Default<none>. Disabled/Ob0 OnlyExplicitInline/Ob1 AnySuitable/Ob2 Para obter mais informações, consulte /Ob (expansão de função embutida).
IntrinsicFunctions	Opcional Boolean parâmetro. Se true, substitui o alguma função chama com intrínseca ou caso contrário os formulários especiais da função que ajudam o seu aplicativo são executados mais rapidamente. Para obter mais informações, consulte /Oi (gerar funções intrínsecas).
MinimalRebuild	Opcional Boolean parâmetro. Se true, permite a recompilação mínima, o que determina se os arquivos de origem do C++ incluem alterados C++ definições (armazenadas nos arquivos de cabeçalho (. h)) de classe deve ser recompilada. Para obter mais informações, consulte /GM (Habilitar recompilação mínima).
MultiProcessorCompilation	Opcional Boolean parâmetro. Se true, use vários processadores para compilação. Este parâmetro cria um processo para cada processador eficaz no seu computador. Para obter mais informações, consulte /MP (com vários processos de compilação). Consulte também o ProcessorNumber parâmetro na tabela.
ObjectFileName	Opcional String parâmetro. Especifica um nome de arquivo de objeto (. obj) ou o diretório a ser usado em vez do padrão. Para obter mais informações, consulte /FO (nome do arquivo de objeto).
ObjectFiles	Opcional String[] parâmetro. Uma lista de arquivos de objeto.
OmitDefaultLibName	Opcional Boolean parâmetro. Se true, omite o nome da biblioteca de tempo de execução c padrão do arquivo de objeto (. obj). Por padrão, o compilador coloca o nome da biblioteca para o arquivo. obj, para direcionar o vinculador correto da biblioteca. Para obter mais informações, consulte /ZL (omitir o nome da biblioteca padrão).
OmitFramePointers	Opcional Boolean parâmetro. Se true, suprime a criação dos ponteiros do quadro na pilha de chamada. Para obter mais informações, consulte /Oy (omissão do ponteiro do quadro).
OpenMPSupport	Opcional Boolean parâmetro. Se true, faz com que o compilador a processar as cláusulas de OpenMP e diretivas. Para obter mais informações, consulte /OpenMP (Ativar OpenMP 2.0 suporte).
Optimization	Opcional String parâmetro. Especifica várias otimizações de código para o tamanho e velocidade. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Disabled/Od MinSpace/O1 MaxSpeed/O2 Full/Ox Para obter mais informações, consulte /O opções (otimizar o código).
PrecompiledHeader	Opcional String parâmetro. Criar ou usar um arquivo de cabeçalho pré-compilado (.pch) durante a compilação. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando NotUsing<none>. Create/Yc Use/Yu Para obter mais informações, consulte /Yc (criar arquivo de cabeçalho pré-compilado) e /Yu (arquivo de cabeçalho pré-compilado de uso). Consulte também o PrecompiledHeaderFile e PrecompiledHeaderOutputFile parâmetros na tabela.
PrecompiledHeaderFile	Opcional String parâmetro. Especifica um nome de arquivo de cabeçalho pré-compilado para criar ou usar. Para obter mais informações, consulte /Yc (criar arquivo de cabeçalho pré-compilado) e /Yu (arquivo de cabeçalho pré-compilado de uso).
PrecompiledHeaderOutputFile	Opcional String parâmetro. Especifica um nome de caminho para um cabeçalho pré-compilado em vez de usar o nome de caminho padrão. Para obter mais informações, consulte /FP (nome.Arquivo de pch).
PreprocessKeepComments	Opcional Boolean parâmetro. Se true, preserva comentários durante o pré-processamento. Para obter mais informações, consulte /C (Preservar comentários durante o pré-processamento).
PreprocessorDefinitions	Opcional String[] parâmetro. Define um símbolo de pré-processamento para seu arquivo de origem. Para obter mais informações, consulte /D (definições de pré-processador).
PreprocessOutput	Opcional ITaskItem[] parâmetro. Define uma matriz de itens de saída de pré-processador que pode ser consumido e emitido por tarefas.
PreprocessOutputPath	Opcional String parâmetro. Especifica o nome do arquivo de saída para o qual o PreprocessToFile parâmetro grava pré-processado saída. Para obter mais informações, consulte /Fi (pré-processar o nome do arquivo de saída).
PreprocessSuppressLineNumbers	Opcional Boolean parâmetro. Se true, pré-processa os arquivos de código-fonte c e C++ e copia os arquivos pré-processado para o dispositivo de saída padrão. Para obter mais informações, consulte /EP (Preprocess para stdout sem # line diretivas).
PreprocessToFile	Opcional Boolean parâmetro. Se true, pré-processa os arquivos de código-fonte c e C++ e grava a saída pré-processado para um arquivo. Para obter mais informações, consulte /P (pré-processar para um arquivo).
ProcessorNumber	Opcional Integer parâmetro. Especifica o número máximo de processadores para usar em uma compilação de multiprocessador. Use esse parâmetro em combinação com o MultiProcessorCompilation parâmetro.
ProgramDataBaseFileName	Opcional String parâmetro. Especifica um nome de arquivo para o arquivo de banco de dados (PDB) do programa. Para obter mais informações, consulte /FD (nome de arquivo de banco de dados do programa).
RuntimeLibrary	Opcional String parâmetro. Indica se um módulo multithread é uma DLL e seleciona as versões de varejo ou depuração da biblioteca de tempo de execução. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando MultiThreaded/MT MultiThreadedDebug/MTd MultiThreadedDLL/MD MultiThreadedDebugDLL/MDd Para obter mais informações, consulte /LD /MD, /MT, (biblioteca Run-Time uso).
RuntimeTypeInfo	Opcional Boolean parâmetro. Se true, adiciona código para verificar os tipos de objeto C++ em tempo de execução (informações de tipo em tempo de execução). Para obter mais informações, consulte /GR (informações de tipo de tempo de execução de enable).
ShowIncludes	Opcional Boolean parâmetro. Se true, faz com que o compilador produzir uma lista dos arquivos de inclusão. Para obter mais informações, consulte /showIncludes (lista incluir arquivos).
SmallerTypeCheck	Opcional Boolean parâmetro. Se true, que reporta um erro de tempo de execução, se um valor é atribuído a um tipo de dados menor e causa uma perda de dados. Para obter mais informações, consulte o /RTCc opção na / RTC (verificações de erro de tempo de execução).
Sources	Obrigatório ITaskItem[] parâmetro. Especifica uma lista dos arquivos de origem separados por espaços.
StringPooling	Opcional Boolean parâmetro. Se true, que permite que o compilador criar uma cópia de strings idênticas na imagem do programa. Para obter mais informações, consulte /GF (eliminar a duplicata de cadeias de caracteres).
StructMemberAlignment	Opcional String parâmetro. Especifica o alinhamento de byte para todos os membros em uma estrutura. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando Default/Zp1 1Byte/Zp1 2Bytes/Zp2 4Bytes/Zp4 8Bytes/Zp8 16Bytes/Zp16 Para obter mais informações, consulte /ZP (alinhamento de membro Struct).
SuppressStartupBanner	Opcional Boolean parâmetro. Se true, impede a exibição do número de versão e copyright mensagem quando inicia a tarefa. Para obter mais informações, consulte /nologo (Suprimir faixa de inicialização) (C/C++).
TrackerLogDirectory	Opcional String parâmetro. Especifica o diretório intermediário onde estão armazenados os logs de rastreamento para esta tarefa. Para obter mais informações, consulte o TLogReadFiles e TLogWriteFiles parâmetros na tabela.
TreatSpecificWarningsAsErrors	Opcional String[] parâmetro. Trata a lista especificada de avisos do compilador como erros. Para obter mais informações, consulte o /wen opção na /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).
TreatWarningAsError	Opcional Boolean parâmetro. Se true, trate todos os avisos do compilador como erros. Para obter mais informações, consulte /WX opção na /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).
TreatWChar_tAsBuiltInType	Opcional Boolean parâmetro. Se true, trate o wchar_t o tipo como um tipo nativo. Para obter mais informações, consulte /ZC:wchar_t (wchar_t é o tipo nativo).
UndefineAllPreprocessorDefinitions	Opcional Boolean parâmetro. Se true, os símbolos específicos da Microsoft que o compilador define de remoções de definição. Para obter mais informações, consulte o /u opção na / U, /u (cancele símbolos).
UndefinePreprocessorDefinitions	Opcional String[] parâmetro. Especifica uma lista de um ou mais símbolos de pré-processamento para cancele. Para obter mais informações, consulte /U opção na / U, /u (cancele símbolos).
UseFullPaths	Opcional Boolean parâmetro. Se true, que exibe o caminho completo de arquivos de código-fonte passadas para o compilador no diagnóstico. Para obter mais informações, consulte /FC (caminho completo do arquivo de código-fonte no diagnóstico).
UseUnicodeForAssemblerListing	Opcional Boolean parâmetro. Se true, faz com que o arquivo de saída a ser criado no formato UTF-8. Para obter mais informações, consulte o /FAu opção na / FA, /Fa (arquivo de listagem).
WarningLevel	Opcional String parâmetro. Especifica o maior nível de aviso é gerado pelo compilador. Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando. ValorOpção de linha de comando TurnOffAllWarnings/W0 Level1/W1 Level2/W2 Level3/W3 Level4/W4 EnableAllWarnings/Wall Para obter mais informações, consulte o /Wn opção em /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).
WholeProgramOptimization	Opcional Boolean parâmetro. Se true, que permite a otimização de programa inteiro. Para obter mais informações, consulte /GL (otimização de programa total).
XMLDocumentationFileName	Opcional String parâmetro. Especifica o nome dos arquivos de documentação XML gerados. Este parâmetro pode ser um nome de arquivo ou diretório. Para obter mais informações, consulte o name argumento no /doc (processo documentação comentários) (C/C++). Consulte também o GenerateXMLDocumentationFiles parâmetro na tabela.
MinimalRebuildFromTracking	Opcional Boolean parâmetro. Se true, uma compilação incremental controlada é executada; Se false, é realizada uma reconstrução.
TLogReadFiles	Opcional ITaskItem[] parâmetro. Especifica uma matriz dos itens que representam a ler logs de controle de arquivo. Um log de controle de arquivo de leitura (.tlog) contém os nomes dos arquivos de entrada que são lidos por uma tarefa e são usados pelo sistema de compilação do projeto para oferecer suporte a compilações incrementais. Para obter mais informações, consulte o TrackerLogDirectory e TrackFileAccess parâmetros na tabela.
TLogWriteFiles	Opcional ITaskItem[] parâmetro. Especifica uma matriz dos itens que representam a gravar arquivo de logs de rastreamento. Um log de controle de gravação de arquivo (.tlog) contém os nomes dos arquivos de saída que são escritos por uma tarefa e são usados pelo sistema de compilação do projeto para oferecer suporte a compilações incrementais. Para obter mais informações, consulte o TrackerLogDirectory e TrackFileAccess parâmetros na tabela.
TrackFileAccess	Opcional Boolean parâmetro. Se true, que rastreia padrões de acesso de arquivo. Para obter mais informações, consulte o TLogReadFiles e TLogWriteFiles parâmetros na tabela.

Consulte também

Outros recursos

Referência de tarefa do MSBuild

Histórico de alterações

Date	History	Motivo
Setembro de 2010	Adicionado Equivalências de opção de parâmetro/linha de comando da tarefa para AssemblerOutput, BasicRuntimeChecks, CallingConvention, e CompileAs.	Comentários do cliente.
Agosto de 2010	Arquivo de leitura definido e logs de controle de gravação de arquivo (.tlog).	Comentários do cliente.