Tarefa CL
Ajusta 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 tarefa.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 diretórios de inclusão). |
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 este 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 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.Seu 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 de opção em / 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
For more information, see the /FA, /FAc, /FAs, and /FAcs options in / 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 em tempo de execução). |
BrowseInformation |
Parâmetro booleano opcional. Se true, cria um arquivo de informações de procura. Para obter mais informações, consulte o /FR de opção em / 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 também consulte / FR, /Fr (criar.Arquivo SBR). |
BufferSecurityCheck |
Parâmetro booleano opcional. Se true, detecta alguns estouros de buffer que substituem 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 |
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 |
Parâmetro booleano opcional. Se true, 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 |
Parâmetro booleano opcional. Se true, informa o compilador para emitir um erro de construções de linguagem que não são compatíveis com ANSI C ou C++ ANSI. Para obter mais informações, consulte o /Za de opção em / Za, /Ze (extensões de linguagem Disable). |
DisableSpecificWarnings |
Parâmetro de [] String opcional. Desativa os números de aviso que são especificados em uma lista delimitada por ponto e vírgula. Para obter mais informações, consulte o /wd de opção em /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 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 (x86). |
EnableFiberSafeOptimizations |
Parâmetro booleano opcional. Se true, segurança de fibra de suporte para dados alocados por meio de armazenamento de segmento local estático, ou seja, os dados alocados por meio de __declspec(thread). Para obter mais informações, consulte /Gt Observação: (armazenamento Local de segmento de suporte de fibra segura). |
EnablePREfast |
Parâmetro booleano opcional. Se true, habilitar a análise de código. Para obter mais informações, consulte /analyze (Análise do código). |
ErrorReporting |
Parâmetro de seqüência de caracteres opcional. Permite que você forneça informações de erro (ICE) interno do compilador diretamente para a 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 |
Parâmetro booleano opcional. Se true, cria um arquivo de listagem que se expandiu atributos injetados no arquivo de origem. Para obter mais informações, consulte /FX (mesclar o código injetado). |
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 |
Parâmetro booleano opcional. Se true, 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 de opção em /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 |
Parâmetro booleano opcional. Se true, implementa o comportamento padrão do C++ no para loops que usam as extensões do Microsoft (/Ze). Para obter mais informações, consulte /ZC:forScope (forçar conformidade no escopo de loop for). |
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 (arquivo incluem o nome forçado). |
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 vinculação). |
GenerateXMLDocumentationFiles |
Opcional Boolean parâmetro. Se true, arquivos de código faz com que o compilador a processar documentação comentários no código-fonte e criar um arquivo de .xdc para cada arquivo de código-fonte com comentários da documentação. Para obter mais informações, consulte /doc (processo documentação comentários) (C/C++).Consulte também o XMLDocumentationFileName parâmetro nesta tabela. |
IgnoreStandardIncludePath |
Opcional Boolean parâmetro. Se true, impede que o compilador procurando arquivos de inclusão nas pastas especificadas na caixa variáveis de ambiente PATH e INCLUDE. Para obter mais informações, consulte /X (Ignorar padrão incluir 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 alguma função chama com intrínseca ou caso contrário os formulários especiais da função que ajudam o seu aplicativo executado 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, que determina se os arquivos de origem do C++ que incluem C++ alterados classe definições (armazenadas nos arquivos de cabeçalho (. h)) 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 compilar.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).Além disso, consulte o ProcessorNumber parâmetro nesta tabela. |
ObjectFileName |
Opcional String parâmetro. Especifica um nome de arquivo do 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 a biblioteca correto. 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 chamadas. 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 (Habilitar 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).Além disso, consulte o PrecompiledHeaderFile e PrecompiledHeaderOutputFile parâmetros nesta 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 que o PreprocessToFile parâmetro grava a saída pré-processado. 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 (pré-processo 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é-processo 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 do arquivo de banco de dados de 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 / MD, /MT, /LD (biblioteca de tempo de execução de uso). |
RuntimeTypeInfo |
Opcional Boolean parâmetro. Se true, adiciona código para verificar os tipos de objetos C++ em tempo de execução (informações de tipo de 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 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, reporta um erro de tempo de execução, se um valor é atribuído a um tipo de dados menor e provoca uma perda de dados. Para obter mais informações, consulte o /RTCc de opção em / RTC (verificações de erro em 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, 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 da mensagem de número de versão e copyright quando a tarefa for iniciada. 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 controle para esta tarefa. Para obter mais informações, consulte o TLogReadFiles e TLogWriteFiles parâmetros nesta tabela. |
TreatSpecificWarningsAsErrors |
Opcional String[] parâmetro. Trata a lista especificada de avisos como erros. Para obter mais informações, consulte o /wen de opção em /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 de opção em /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso). |
TreatWChar_tAsBuiltInType |
Opcional Boolean parâmetro. Se true, trate o wchar_t 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 de opção em / 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 de opção em / U, /u (cancele símbolos). |
UseFullPaths |
Opcional Boolean parâmetro. Se true, exibe o caminho completo de arquivos de código fonte passado 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 seja criado no formato UTF-8. Para obter mais informações, consulte o /FAu de opção em / FA, /Fa (arquivo de listagem). |
WarningLevel |
Opcional String parâmetro. Especifica o maior nível de aviso que deve ser 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 na /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso). |
WholeProgramOptimization |
Opcional Boolean parâmetro. Se true, 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 na /doc (processo documentação comentários) (C/C++).Consulte também o GenerateXMLDocumentationFiles parâmetro nesta tabela. |
MinimalRebuildFromTracking |
Opcional Boolean parâmetro. Se true, é realizada uma compilação incremental controlada; Se false, uma reconstrução é executada. |
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 nesta 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 nesta tabela. |
TrackFileAccess |
Opcional Boolean parâmetro. Se true, rastreia padrões de acesso de arquivo. Para obter mais informações, consulte o TLogReadFiles e TLogWriteFiles parâmetros nesta tabela. |