Compartilhar via


tarefa CL

Observação

Essa tarefa só está disponível ao usar o sistema de compilação C++.

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

Parâmetros

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

  • AdditionalIncludeDirectories

    Parâmetro String[] opcional.

    Adiciona um diretório à lista de diretórios que são pesquisados para arquivos de inclusão.

    Para obter mais informações, confira /I (Diretórios de inclusão adicionais).

  • AdditionalOptions

    Parâmetro String opcional.

    Uma lista de opções de linha de comando. Por exemplo, "/<option1> /<option2> /<option#>". Use esse parâmetro para especificar opções de linha de comando não representadas por nenhum outro parâmetro da tarefa.

    Para obter mais informações, confira Opções do compilador.

  • AdditionalUsingDirectories

    Parâmetro String[] opcional.

    Especifica um diretório em que o compilador pesquisará para resolver referências de arquivo passadas para diretiva #using.

    Para obter mais informações, confira /AI (Especificar diretórios de metadados).

  • AlwaysAppend

    Parâmetro String opcional.

    Uma cadeia de caracteres sempre é emitida na linha de comando. Seu valor padrão é "/c".

  • AssemblerListingLocation

    Cria um arquivo de listagem que contém o código do assembly.

    Para obter mais informações, confira a opção /Fa em /FA, /Fa (Arquivo de listagem).

  • AssemblerOutput

    Parâmetro String opcional.

    Cria um arquivo de listagem que contém o código do assembly.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

    • NoListing - <none>

    • AssemblyCode - /FA

    • AssemblyAndMachineCode - /FAc

    • AssemblyAndSourceCode - /FAs

    • All - /FAcs

      Para obter mais informações, confira as opções /FA, /FAc, /FAs e /FAcs opções em /FA, /Fa (Arquivo de listagem).

  • BasicRuntimeChecks

    Parâmetro String opcional.

    Habilita e desabilita o recurso de verificações de erro em tempo de execução, em conjunto com o pragma runtime_checks.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • BrowseInformation

    Parâmetro Boolean opcional.

    Se true, criará um arquivo de informações de procura.

    Para obter mais informações, confira a opção /FR em /FR, /Fr (Criar arquivo .sbr).

  • BrowseInformationFile

    Parâmetro String opcional.

    Especifica um nome de arquivo para o arquivo de informações de procura.

    Para obter mais informações, confira o parâmetro BrowseInformation nessa tabela e /FR, /Fr (Criar arquivo .sbr).

  • BufferSecurityCheck

    Parâmetro Boolean opcional.

    Se true, detectará alguns estouros de buffer que substituem o endereço de retorno, uma técnica comum para explorar o código que não impõe restrições de tamanho do buffer.

    Para obter mais informações, confira /GS (Verificação de segurança do buffer).

  • BuildingInIDE

    Parâmetro Boolean opcional.

    Se true, indicará que MSBuild é invocado pelo IDE. Caso contrário, MSBuild será invocado na linha de comando.

  • CallingConvention

    Parâmetro String opcional.

    Especifica a convenção de chamada, que determina a ordem na qual os argumentos de função 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 funções individuais.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • CompileAs

    Parâmetro String opcional.

    Especifica se o arquivo de entrada deve ser compilado como um arquivo de origem C ou C++.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • CompileAsManaged

    Parâmetro String opcional.

    Permite que aplicativos e componentes usem recursos do CLR (Common Language Runtime).

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • CreateHotpatchableImage

    Parâmetro Boolean opcional.

    Se true, informará ao compilador para preparar uma imagem para aplicação de patch sob demanda. Esse parâmetro garante que a primeira instrução de cada função tenha dois bytes, o que é necessário para aplicação de patch sob demanda.

    Para obter mais informações, confira /hotpatch (Criar imagem para patch instantâneo).

  • DebugInformationFormat

    Parâmetro String opcional.

    Seleciona o tipo de informações de depuração criado para o programa e indica se essas informações são mantidas em arquivos de objeto (.obj) ou em um PDB (banco de dados de programa).

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • DisableLanguageExtensions

    Parâmetro Boolean opcional.

    Se true, dirá ao compilador para emitir um erro para construções de linguagem que não sejam compatíveis com ANSI C ou ANSI C++.

    Para obter mais informações, confira a opção /Za em /Za, /Ze (Desabilitar extensões de idioma).

  • DisableSpecificWarnings

    Parâmetro String[] opcional.

    Desabilita os números de aviso especificados em uma lista delimitada por ponto e vírgula.

    Para obter mais informações, confira a opção /wd em /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Nível de aviso).

  • EnableEnhancedInstructionSet

    Parâmetro String opcional.

    Especifica a arquitetura para geração de código que usa as instruções Streaming SIMD Extensions (SSE), Streaming SIMD Extensions 2 (SSE2) e Advanced Vector Extensions (AVX).

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

    • NoExtensions - /arch:IA32

    • StreamingSIMDExtensions - /arch:SSE

    • StreamingSIMDExtensions2 - /arch:SSE2

    • AdvancedVectorExtensions - /arch:AVX

    • AdvancedVectorExtensions2 - /arch:AVX2

    • AdvancedVectorExtensions512 - /arch:AVX512

      Para obter mais informações, consulte /arch (x86).

  • EnableFiberSafeOptimizations

    Parâmetro Boolean opcional.

    Se true, dê suporte a segurança de fibra para dados alocados usando armazenamento local de thread estático, ou seja, dados alocados usando __declspec(thread).

    Para obter mais informações, confira /GT (Dar suporte ao armazenamento local de thread com segurança de fibra).

  • EnablePREfast

    Parâmetro Boolean opcional.

    Se true, habilitará análise de código.

    Para obter mais informações, confira /analyze (Análise de código).

  • ErrorReporting

    Parâmetro String opcional.

    Permite que você forneça informações de ICE (erro interno do compilador) diretamente à Microsoft. Por padrão, a configuração em compilações do IDE é Aviso e a configuração em compilações de linha de comando é Fila.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • ExceptionHandling

    Parâmetro String opcional.

    Especifica o modelo de tratamento de exceções a ser utilizado pelo compilador.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • ExpandAttributedSource

    Parâmetro Boolean opcional.

    Se true, criará um arquivo de listagem com atributos expandidos injetados no arquivo de origem.

    Para obter mais informações, confira /Fx (Mesclar código injetado).

  • FavorSizeOrSpeed

    Parâmetro String opcional.

    Especifica se tamanho ou velocidade do código deve ser favorecido.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • FloatingPointExceptions

    Parâmetro Boolean opcional.

    Se true, habilitará o modelo de exceção de ponto flutuante confiável. As exceções serão geradas imediatamente depois de serem disparadas.

    Para obter mais informações, confira a opção /fp:except em /fp (Especificar comportamento de ponto flutuante).

  • FloatingPointModel

    Parâmetro String opcional.

    Define o modelo de ponto flutuante.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • ForceConformanceInForLoopScope

    Parâmetro Boolean opcional.

    Se true, implementará o comportamento padrão do C++ em loops for que usem extensões da Microsoft (/Ze).

    Para obter mais informações, confira /Zc:forScope (Forçar conformidade no escopo do loop For).

  • ForcedIncludeFiles

    Parâmetro String[] opcional.

    Faz o pré-processador processar um ou mais arquivos de cabeçalho especificados.

    Para obter mais informações, confira /FI (Nomear arquivo de inclusão forçada).

  • ForcedUsingFiles

    Parâmetro String[] opcional.

    Faz o pré-processador processar um ou mais arquivos #using especificados.

    Para obter mais informações, confira /FU (Nomear arquivo #using forçado).

  • FunctionLevelLinking

    Parâmetro Boolean opcional.

    Se true, permitirá que o compilador empacote funções individuais na forma de funções empacotadas (COMDATs).

    Para obter mais informações, confira /Gy (Habilitar vinculação no nível de função).

  • GenerateXMLDocumentationFiles

    Parâmetro Boolean opcional.

    Se ele for true, fará o compilador processar comentários da documentação em arquivos de código-fonte e criar um arquivo .xdc para cada arquivo de código-fonte que tenha comentários da documentação.

    Para obter mais informações, confira /doc (Processar comentários da documentação) (C/C++). Consulte também o parâmetro XMLDocumentationFileName nesta tabela.

  • IgnoreStandardIncludePath

    Parâmetro Boolean opcional.

    Se true, evitará que o compilador pesquise os arquivos de inclusão em diretórios especificados nas variáveis de ambiente PATH e INCLUDE.

    Para obter mais informações, confira /X (Ignorar caminhos de inclusão padrão).

  • InlineFunctionExpansion

    Parâmetro String opcional.

    Especifica o nível de expansão de função embutida para o build.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • IntrinsicFunctions

    Parâmetro Boolean opcional.

    Se true, substituirá algumas chamadas de função com formas da função intrínsecas ou especiais de outra maneira que ajudem o aplicativo a ser executado mais rapidamente.

    Para obter mais informações, confira /Oi (Gerar funções intrínsecas).

  • MinimalRebuild

    Parâmetro Boolean opcional. Essa opção foi preterida.

    Se true, habilitará recompilação mínima, que determina se os arquivos de origem C++ que incluem definições de classe C++ alteradas (armazenadas nos arquivos de cabeçalho (.h)) devem ser recompilados.

    Para obter mais informações, confira /Gm (Habilitar recompilação mínima).

  • MultiProcessorCompilation

    Parâmetro Boolean opcional.

    Se true, use vários processadores para compilar. Esse parâmetro cria um processo para cada processador efetivo no seu computador.

    Para obter mais informações, confira /MP (Criar com vários processos). Consulte também o parâmetro ProcessorNumber nesta tabela.

  • ObjectFileName

    Parâmetro String opcional.

    Especifica um nome de arquivo de objeto (.obj) ou diretório a ser usado no lugar do padrão.

    Para obter mais informações, confira /Fo (Nome do arquivo-objeto).

  • ObjectFiles

    Parâmetro String[] opcional.

    Uma lista de arquivos de objeto.

  • OmitDefaultLibName

    Parâmetro Boolean opcional.

    Se ele for true, omitirá o nome da biblioteca em tempo de execução C padrão do arquivo-objeto (.obj). Por padrão, o compilador coloca o nome da biblioteca no arquivo .obj para direcionar o vinculador à biblioteca correta.

    Para obter mais informações, confira /Zl (Omitir o nome da biblioteca padrão).

  • OmitFramePointers

    Parâmetro Boolean opcional.

    Se true, suprimirá a criação de ponteiros de quadro na pilha de chamadas.

    Para obter mais informações, confira /Oy (Omissão do ponteiro de quadro).

  • OpenMPSupport

    Parâmetro Boolean opcional.

    Se true, fará o compilador processar cláusulas e diretivas OpenMP.

    Para obter mais informações, confira /openmp (Habilitar suporte a OpenMP 2.0).

  • Otimização

    Parâmetro String opcional.

    Especifica várias otimizações de código para velocidade e tamanho.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • PrecompiledHeader

    Parâmetro String opcional.

    Crie ou use um arquivo de cabeçalho pré-compilado (.pch) durante o build.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • PrecompiledHeaderFile

    Parâmetro String opcional.

    Especifica um nome de arquivo de cabeçalho pré-compilado para criar ou usar.

    Para obter mais informações, confira /Yc (Criar arquivo de cabeçalho pré-compilado) e /Yu (Usar arquivo de cabeçalho pré-compilado).

  • PrecompiledHeaderOutputFile

    Parâmetro String opcional.

    Especifica um nome de caminho para um cabeçalho pré-compilado em vez de usar o nome do caminho padrão.

    Para obter mais informações, confira /Fp (Nomear arquivo .pch).

  • PreprocessKeepComments

    Parâmetro Boolean opcional.

    Se true, preservará comentários durante o pré-processamento.

    Para obter mais informações, confira /C (Preservar comentários durante o pré-processamento).

  • PreprocessorDefinitions

    Parâmetro String[] opcional.

    Define um símbolo de pré-processamento para seu arquivo de origem.

    Para obter mais informações, confira /D (Definições de pré-processador).

  • PreprocessOutput

    Parâmetro ITaskItem[] opcional.

    Define uma matriz de itens de saída do pré-processador que podem ser consumidos e emitidos por tarefas.

  • PreprocessOutputPath

    Parâmetro String opcional.

    Especifica o nome do arquivo de saída para o qual o parâmetro PreprocessToFile grava a saída pré-processada.

    Para obter mais informações, confira /Fi (Pré-processar nome de arquivo de saída).

  • PreprocessSuppressLineNumbers

    Parâmetro Boolean opcional.

    Se true, pré-processará arquivos de origem em C e C++ e copiará os arquivos pré-processados para o dispositivo de saída padrão.

    Para obter mais informações, confira /EP (Pré-processar para stdout sem diretivas #line).

  • PreprocessToFile

    Parâmetro Boolean opcional.

    Se true, pré-processará arquivos de origem em C e C++ e gravará a saída pré-processada em um arquivo.

    Para obter mais informações, confira /P (Pré-processar para um arquivo).

  • ProcessorNumber

    Parâmetro Integer opcional.

    Especifica o número máximo de processadores a serem usados em uma compilação multiprocessador. Use esse parâmetro em combinação com o parâmetro MultiProcessorCompilation.

  • ProgramDataBaseFileName

    Parâmetro String opcional.

    Especifica um nome de arquivo para o arquivo PDB (banco de dados do programa).

    Para obter mais informações, confira /Fd (Nome do arquivo de banco de dados de programa).

  • RuntimeLibrary

    Parâmetro String opcional.

    Indica se um módulo com multithread é uma DLL e seleciona versões de varejo ou de depuração da biblioteca em tempo de execução.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • RuntimeTypeInfo

    Parâmetro Boolean opcional.

    Se true, adicionará código para verificar os tipos de objeto C++ no tempo de execução (informações de tipo de tempo de execução).

    Para obter mais informações, confira /GR (Habilitar informações de tipo em tempo de execução).

  • ShowIncludes

    Parâmetro Boolean opcional.

    Se true, fará o compilador gerar uma lista dos arquivos de inclusão.

    Para obter mais informações, confira /showIncludes (Listar arquivos de inclusão).

  • SmallerTypeCheck

    Parâmetro Boolean opcional.

    Se true, relatará um erro em tempo de execução se um valor for atribuído a um tipo de dados menor e provocará perda de dados.

    Para obter mais informações, confira a opção /RTCc em /RTC (Verificações de erro em tempo de execução).

  • Fontes

    Parâmetro ITaskItem[] obrigatório.

    Especifica uma lista de arquivos de origem separados por espaços.

  • StringPooling

    Parâmetro Boolean opcional.

    Se true, permitirá que o compilador crie uma cópia de cadeias de caracteres idênticas na imagem do programa.

    Para obter mais informações, confira /GF (Eliminar cadeias de caracteres duplicadas).

  • StructMemberAlignment

    Parâmetro String opcional.

    Especifica o alinhamento de byte para todos os membros em uma estrutura.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • SuppressStartupBanner

    Parâmetro Boolean opcional.

    Se true, impedirá a exibição da mensagem de direitos autorais e de número de versão quando a tarefa for iniciada.

    Para obter mais informações, confira /nologo (Suprimir faixa de inicialização) (C/C++).

  • TrackerLogDirectory

    Parâmetro String opcional.

    Especifica o diretório intermediário em que os logs de rastreamento para essa tarefa são armazenados.

    Para obter mais informações, consulte os parâmetros TLogReadFiles e TLogWriteFiles nesta tabela.

  • TreatSpecificWarningsAsErrors

    Parâmetro String[] opcional.

    Trata a lista especificada de avisos do compilador como erros.

    Para obter mais informações, confira a opção /wen em /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Nível de aviso).

  • TreatWarningAsError

    Parâmetro Boolean opcional.

    Se true, tratará todos os avisos do compilador como erros.

    Para obter mais informações, confira a opção /WX em /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Nível de aviso).

  • TreatWChar_tAsBuiltInType

    Parâmetro Boolean opcional.

    Se true, trate o tipo wchar_t como um tipo nativo.

    Para obter mais informações, confira /Zc:wchar_t (wchar_t é o tipo nativo).

  • UndefineAllPreprocessorDefinitions

    Parâmetro Boolean opcional.

    Se true, cancelará a definição de símbolos específicos da Microsoft que o compilador definir.

    Para obter mais informações, confira a opção /u em /U, /u (Excluir definições de símbolos).

  • UndefinePreprocessorDefinitions

    Parâmetro String[] opcional.

    Especifica uma lista de um ou mais símbolos de pré-processador a excluir.

    Para obter mais informações, confira a opção /U em /U, /u (Excluir definições de símbolos).

  • UseFullPaths

    Parâmetro Boolean opcional.

    Se true, exibirá o caminho completo dos arquivos de código-fonte passados para o compilador no diagnóstico.

    Para obter mais informações, confira /FC (Caminho completo do arquivo de código-fonte no diagnóstico).

  • UseUnicodeForAssemblerListing

    Parâmetro Boolean opcional.

    Se true, fará o arquivo de saída ser criado em formato UTF-8.

    Para obter mais informações, confira a opção /FAu em /FA, /Fa (Arquivo de listagem).

  • WarningLevel

    Parâmetro String opcional.

    Especifica o nível mais alto de aviso que deverá ser gerado pelo compilador.

    Especifique um dos valores a seguir, cada um correspondendo a uma opção de linha de comando.

  • WholeProgramOptimization

    Parâmetro Boolean opcional.

    Se true, habilitará a otimização de todo o programa.

    Para obter mais informações, confira /GL (Otimização do programa inteiro).

  • XMLDocumentationFileName

    Parâmetro String opcional.

    Especifica o nome dos arquivos de documentação XML gerados. Esse parâmetro pode ser um nome de arquivo ou de diretório.

    Para obter mais informações, confira o argumento name em /doc (Processar comentários da documentação) (C/C++). Consulte também o parâmetro GenerateXMLDocumentationFiles nesta tabela.

  • MinimalRebuildFromTracking

    Parâmetro Boolean opcional.

    Se true, um build incremental controlada será executada; se false, será executada uma recompilação.

  • TLogReadFiles

    Parâmetro ITaskItem[] opcional.

    Especifica uma matriz de itens que representam os logs de acompanhamento do arquivo de leitura.

    Um log de acompanhamento do arquivo de leitura (.tlog) contém os nomes dos arquivos de entrada lidos por uma tarefa e é usado pelo sistema de build do projeto para dar suporte a builds incrementais. Para obter mais informações, consulte os parâmetros TrackerLogDirectory e TrackFileAccess nesta tabela.

  • TLogWriteFiles

    Parâmetro ITaskItem[] opcional.

    Especifica uma matriz de itens que representam os logs de acompanhamento do arquivo de gravação.

    Um log de acompanhamento do arquivo de gravação (.tlog) contém os nomes dos arquivos de saída gravados por uma tarefa e é usado pelo sistema de build do projeto para dar suporte a builds incrementais. Para obter mais informações, consulte os parâmetros TrackerLogDirectory e TrackFileAccess nesta tabela.

  • TrackFileAccess

    Parâmetro Boolean opcional.

    Se true, controlará os padrões de acesso de arquivo.

    Para obter mais informações, consulte os parâmetros TLogReadFiles e TLogWriteFiles nesta tabela.

Confira também